1ckuid(1) User Commands ckuid(1)
2
6 ckuid, erruid, helpuid, valuid - prompts for and validates a user ID
7
9 ckuid [-Q] [-W width] [-m] [-d default] [-h help]
10 [-e error] [-p prompt] [-k pid [-s signal]]
11 /usr/sadm/bin/erruid [-W width] [-e error]
14 /usr/sadm/bin/helpuid [-W width] [-m] [-h help]
17 /usr/sadm/bin/valuid input
20
23 The ckuid utility prompts a user and validates the response. It
24 defines, among other things, a prompt message whose response should be
25 an existing user ID, text for help and error messages, and a default
26 value (which are returned if the user responds with a RETURN).
27 All messages are limited in length to 70 characters and are formatted
30 automatically. Any white space used in the definition (including NEW‐
31 LINE) is stripped. The -W option cancels the automatic formatting. When
32 a tilde is placed at the beginning or end of a message definition, the
33 default text is inserted at that point, allowing both custom text and
34 the default text to be displayed.
35 If the prompt, help or error message is not defined, the default mes‐
38 sage (as defined under NOTES) is displayed.
39 Three visual tool modules are linked to the ckuid command. They are
42 erruid (which formats and displays an error message), helpuid (which
43 formats and displays a help message), and valuid (which validates a
44 response). These modules should be used in conjunction with FML
45 objects. In this instance, the FML object defines the prompt.
46
48 The following options are supported:
49 -d default Defines the default value as default. The default is not
51 validated and so does not have to meet any criteria.
52 -e error Defines the error message as error.
55 -h help Defines the help messages as help.
58 -k pid Specifies that process ID pid is to be sent a signal if
61 the user chooses to abort.
62 -m Displays a list of all logins when help is requested or
65 when the user makes an error.
66 -p prompt Defines the prompt message as prompt.
69 -Q Specifies that quit will not be allowed as a valid
72 response.
73 -s signal Specifies that the process ID pid defined with the -k
76 option is to be sent signal signal when quit is chosen.
77 If no signal is specified, SIGTERM is used.
78 -W width Specifies that prompt, help and error messages will be
81 formatted to a line length of width.
82
85 The following operand is supported:
86 input Input to be verified against /etc/passwd.
88
91 The following exit values are returned:
92 0 Successful execution.
94 1 EOF on input, or negative width on -W option, or usage error.
97 2 Usage error.
100 3 User termination (quit).
103
106 See attributes(5) for descriptions of the following attributes:
107 ┌─────────────────────────────┬─────────────────────────────┐
112 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
113 ├─────────────────────────────┼─────────────────────────────┤
114 │Availability │SUNWcsu │
115 └─────────────────────────────┴─────────────────────────────┘
116
118 attributes(5)
119
121 The default prompt for ckuid is:
122 Enter the login name of an existing user [?,q]:
124 The default error message is:
129 ERROR - Please enter the login name of an existing user.
131 If the -m option is used, the default error message is:
136 ERROR: Please enter one of the following login names: <List>
138 The default help message is:
143 Please enter the login name of an existing user.
145 If the -m option is used, the default help message is:
150 Please enter one of the following login names: <List>
152 When the quit option is chosen (and allowed), q is returned along with
157 the return code 3. The valuid module will not produce any output. It
158 returns 0 for success and non-zero for failure.
159SunOS 5.11 14 Sep 1992 ckuid(1)