CKGID(1)							      CKGID(1)

NAME
       ckgid, errgid, helpgid, valgid - prompts for and validates a group id

SYNOPSIS
       ckgid [-Q] [-W width] [-m] [-d default] [-h help]
	    [-e error] [-p prompt] [-k pid [-s signal]]

       /usr/sadm/bin/errgid [-W width] [-e error]

       /usr/sadm/bin/helpgid [-W width] [-m] [-h help]

       /usr/sadm/bin/valgid input

DESCRIPTION
       ckgid  prompts  a  user	and  validates the response. It defines, among
       other things, a prompt message whose response  should  be  an  existing
       group  ID, text for help and error messages, and a default value (which
       will be returned if the user responds with a carriage return).

       All messages are limited in length to 70 characters and	are  formatted
       automatically.  Any  white space used in the definition (including new‐
       line) is stripped. The -W option cancels the automatic formatting. When
       a  tilde is placed at the beginning or end of a message definition, the
       default text will be inserted at that point, allowing both custom  text
       and the default text to be displayed.

       If  the	prompt, help or error message is not defined, the default mes‐
       sage (as defined under NOTES) will be displayed.

       Three visual tool modules are linked to the ckgid  command.   They  are
       errgid  (which  formats	and displays an error message), helpgid (which
       formats and displays a help message), and  valgid  (which  validates  a
       response).  These  modules  should  be  used  in	 conjunction  with FML
       objects. In this instance, the FML object defines the prompt.

OPTIONS
       The following options are supported:

       -d default
		     Defines the default value as default. The default is  not
		     validated and so does not have to meet any criteria.

       -e error
		     Defines the error message as  error.

       -h help
		     Defines the help messages as  help.

       -k pid
		     Specifies	that  process ID pid is to be sent a signal if
		     the user chooses to abort.

       -m
		     Displays a list of all groups when help is	 requested  or
		     when the user makes an error.

       -p prompt
		     Defines the prompt message as prompt.

       -Q
		     Specifies	that  quit  will  not  be  allowed  as a valid
		     response.

       -s signal
		     Specifies that the process ID pid	defined	 with  the  -k
		     option  is to be sent signal  signal when quit is chosen.
		     If no signal is specified, SIGTERM is used.

       -W width
		     Specifies that prompt, help and error  messages  will  be
		     formatted to a line length of width.

OPERANDS
       The following operand is supported:

       input
		Input to be verified against /etc/group.

EXIT STATUS
       The following exit values are returned:

       0
	    Successful execution.

       1
	    EOF on input, or negative width on -W option, or usage error.

       3
	    User termination (quit).

SEE ALSO
       attributes(5)

NOTES
       The default prompt for ckgid is:

	 Enter the name of an existing group [?,q]:

       The default error message is:

	 ERROR: Please enter one of the following group names: [List]

       If  the -m option of ckgid is used, a list of valid groups is displayed
       here.

       The default help message is:

	 ERROR: Please enter one of the following group names: [List]

       If the -m option of ckgid is used, a  list of valid groups is displayed
       here.

       When  the quit option is chosen (and allowed), q is returned along with
       the return code 3. The valgid module will not produce any  output.   It
       returns 0 for success and non-zero for failure.

				 Sep 14, 1992			      CKGID(1)

Vote for polarhome