csauseradd (Registering and updating user information for password authentication)
- Organization of this page
Format
csauseradd [-h]
-user user-name
-pass password
[-r]
-f password-authentication-information-definition-file
Function
Registers or updates the user information (user name and password) required for password authentication included in user authentication. You can register any number of users.
The registered or updated password authentication information takes effect after the service adapter that uses the password authentication information starts. If you execute the command when the service adapter is running, the registered or updated password authentication information takes effect after the service adapter starts the next time.
Note the following when you execute the command:
-
Specify access permissions so that only the administrator who executes the command can update and reference the password authentication information definition file.
-
When updating the password authentication information definition file, we recommend that you create a backup file.
Arguments
-h
Displays the usage of the command. When you specify this option, all other options are ignored even if specified.
-user user-name ~ <halfwidth alphanumeric characters and halfwidth symbols> ((1 to 80 characters))
Specifies the user name to be registered or updated.
You can specify halfwidth alphanumeric characters, halfwidth symbols (0x21 to 0x7E in ASCII encoding), and halfwidth spaces (0x20 in ASCII encoding). The characters are case sensitive. You can use the following halfwidth symbols:
-
Exclamation mark (!)
-
Double quotation mark (")
-
Hash mark (#)
-
Dollar sign ($)
-
Percent sign (%)
-
Ampersand (&)
-
Apostrophe mark (')
-
Left parenthesis (()
-
Right parenthesis ())
-
Asterisk (*)
-
Plus sign (+)
-
Comma (,)
-
Hyphen (-)
-
Period (.)
-
Forward slash (/)
-
Colon (:)
-
Semicolon (;)
-
Left angle bracket (<)
-
Right angle bracket (>)
-
Equal sign (=)
-
Question mark (?)
-
At mark (@)
-
Left square bracket ([)
-
Right square bracket (])
-
Yen sign (\)
-
Caret (^)
-
Underscore (_)
-
Grave accent mark (`)
-
Left curly bracket ({)
-
Right curly bracket (})
-
Vertical bar (|)
-
Swung dash (~)
-pass password ~ <halfwidth alphanumeric characters and halfwidth symbols> ((1 to 80 characters))
Specifies the password for the user name to be registered or updated.
You can specify halfwidth alphanumeric characters, halfwidth symbols (0x21 to 0x7E in ASCII encoding), and halfwidth spaces (0x20 in ASCII encoding). The characters are case sensitive. You can use the following halfwidth symbols.
-
Exclamation mark (!)
-
Double quotation mark (")
-
Hash mark (#)
-
Dollar sign ($)
-
Percent sign (%)
-
Ampersand (&)
-
Apostrophe mark (')
-
Left parenthesis (()
-
Right parenthesis ())
-
Asterisk (*)
-
Plus sign (+)
-
Comma (,)
-
Hyphen (-)
-
Period (.)
-
Forward slash (/)
-
Colon (:)
-
Semicolon (;)
-
Left angle bracket (<)
-
Right angle bracket (>)
-
Equal sign (=)
-
Question mark (?)
-
At mark (@)
-
Left square bracket ([)
-
Right square bracket (])
-
Yen sign (\)
-
Caret (^)
-
Underscore (_)
-
Grave accent mark (`)
-
Left curly bracket ({)
-
Right curly bracket (})
-
Vertical bar (|)
-
Swung dash (~)
-r
Specify this option to change the password of the user that is already registered.
-f password-authentication-information-definition-file
Specifies the path of the password authentication information definition file as a relative or absolute path. To include spaces in the path, enclose the entire option argument in double quotation marks (").
If the specified file does not exist, one of the following operations is performed:
-
When the password authentication information is registered
If the specified file does not exist, a password authentication information definition file with the specified name is created. However, an error occurs if the specified directory does not exist.
-
When the password authentication information is updated (with the -r argument specified)
If the specified file does not exist, an error occurs.
Return values
|
Return value |
Meaning |
|---|---|
|
0 |
The command terminated normally. |
|
1 |
The command terminated abnormally. |
|
9 |
An error occurred when checking the execution permission. |
Note
-
Do not directly edit the password authentication information definition file.