helpgid man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

ckgid(1)			 User Commands			      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	crite‐
		       ria.

       -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 cho‐
		       sen. 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).

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWcsu			   │
       └─────────────────────────────┴─────────────────────────────┘

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.

SunOS 5.10			  14 Sep 1992			      ckgid(1)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net