Man page - supysonic-cli-user(1)

Packages contains this manual

Manual

SUPYSONIC-CLI-USER

NAME
SYNOPSIS
DESCRIPTION
ARGUMENTS
OPTIONS
EXAMPLES
SEE ALSO
AUTHOR
COPYRIGHT

NAME

supysonic-cli-user - Supysonic user management commands

SYNOPSIS

supysonic-cli user --help

supysonic-cli user list

supysonic-cli user add < user > [ --password < password >] [ --email < email >]

supysonic-cli user delete < user >

supysonic-cli user changepass < user > [ --password < password >]

supysonic-cli user setroles [ --admin | --noadmin ] [ --jukebox | --nojukebox ] < user >

supysonic-cli user rename < user > < newname >

DESCRIPTION

The supysonic-cli user subcommand manages users, allowing to list them, add a new user, delete an existing user, and change their password or roles.

ARGUMENTS

list

List all the users.

add < user > [ --password < password >] [ --email < email >]

Add a new user named < user >. Will prompt for a password if it isn't given with the --password option.

delete < user >

Delete the user < user >.

changepass < user > [ --password < password >]

Change the password of user < user >. Will prompt for the new password if not provided.

setroles [ --admin | --noadmin ] [ --jukebox | --nojukebox ] < user >

Give or remove rights to user < user >.

rename < user > < newname >

Rename the user < user > to < newname >.

OPTIONS

-h , --help

Shows help and exits. Depending on where this option appears it will either list the available commands or display help for a specific command.

-p < password >, --password < password >

Specify the user's password upon creation.

-e < email >, --email < email >

Specify the user's email.

The next options relate to user roles. They work in pairs, one option granting a right while the other revokes it; obviously options of the same pair are mutually exclusive.

The long options are named with the matching right, prefix it with a no to revoke the right. For short options, the upper case letter grants the right while the lower case letter revokes it. Short options might be combined into a single one such as -aJ to both revoke the admin right and grant the jukebox one.
-A
, --admin

Grant admin rights.

-a , --noadmin

Revoke admin rights.

-J , --jukebox

Grant jukebox rights.

-j , --nojukebox

Revoke jukebox rights.

EXAMPLES

To add a new admin user named MyUserName having password MyAwesomePassword :

$ supysonic-cli user add MyUserName -p MyAwesomePassword
$ supysonic-cli user setroles -A MyUserName

SEE ALSO

supysonic-cli (1) , supysonic-cli-folder (1) , supysonic-server (1) , supysonic-daemon (1)

AUTHOR

Louis-Philippe Véronneau, Alban Féron

COPYRIGHT

2013-2023, Alban Féron