admin man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

admin(1)							      admin(1)

NAME
       admin - create and administer SCCS files

SYNOPSIS
       login]  ...  flag[flag-val]]  ...  flag[flag-val]] ... mrlist] ... rel]
	      [name]] [comment]] file ...

       login] ... flag[flag-val]] ... flag[flag-val]] ... mrlist] ...  [name]]
	      [comment]] file ...

       login] ... login] ... flag[flag-val]] ... mrlist] ... rel] [name]] file
	      ...

       file ...

       file ...

DESCRIPTION
       The command is used to create new SCCS files and change the  parameters
       of existing ones.  Arguments to which may appear in any order, ( unless
       is specified as an argument, in which  case  all	 arguments  after  are
       treated	as  files  )  consist  of option arguments, beginning with and
       named files (note that SCCS file names must begin with  the  characters
       If  a  named  file does not exist, it is created and its parameters are
       initialized according to the specified  option  arguments.   Parameters
       not initialized by an option argument are assigned a default value.  If
       a named file does exist, parameters corresponding to  specified	option
       arguments are changed, and other parameters are left unaltered.

       If  directory is named instead of file, acts on each file in directory,
       except that non-SCCS files (the last component of the  path  name  does
       not begin with and unreadable files are silently ignored.  If a name of
       is given, the standard input is read, and each  line  of	 the  standard
       input  is  assumed  to  be  the	name  of an SCCS file to be processed.
       Again, non-SCCS files and unreadable files are silently ignored.

       The option arguments apply independently to all	named  files,  whether
       one  file  or  many.   In  the  following  discussion,  each  option is
       explained as if only one file is specified, although they affect single
       or multiple files identically.

   Options
       The command supports the following options and command-line arguments:

	      This option indicates that a new
			     SCCS file is to be created.

	      The	     name  of a file from which the contents for a new
			     SCCS file is to be taken.	(if name is  a	binary
			     file,  then  you  must specify the -b option) The
			     contents constitutes the first delta of the  file
			     (see  the option for the delta numbering scheme).
			     If the option is used but the file name is	 omit‐
			     ted, the text is obtained by reading the standard
			     input until an end-of-file	 is  encountered.   If
			     this  option is omitted, the SCCS file is created
			     with an empty initial delta.  Only one SCCS  file
			     can  be created by an command on which the option
			     is supplied.  Using a single  to  create  two  or
			     more  SCCS	 files	requires  that they be created
			     empty (no option).	 Note that the option  implies
			     the option.

	      Encode the contents of name, specified to the
			     option.  This keyletter must be used if name is a
			     binary file; otherwise, a binary file will not be
			     handled properly by SCCS commands.

	      The release    (rel)  into  which the initial delta is inserted.
			     This option can be used only  if  the  option  is
			     also  used.   If the option is not used, the ini‐
			     tial delta is inserted into release 1.  The level
			     of the initial delta is always 1 (by default ini‐
			     tial deltas are named 1.1).

	      The	     name of a file from which	descriptive  text  for
			     the  SCCS	file is to be taken.  If the option is
			     used and is creating a new SCCS file (the	and/or
			     options are also used), the descriptive text file
			     name must also  be	 supplied.   In	 the  case  of
			     existing SCCS files:

			     ·	A option without a file name causes removal of
				descriptive text (if  any)  currently  in  the
				SCCS file.

			     ·	A option with a file name causes text (if any)
				in the named file to replace  the  descriptive
				text (if any) currently in the SCCS file.

	      This option specifies a
			     flag,  and	 possibly  a value for the flag, to be
			     placed in the SCCS file.  Several options can  be
			     supplied on a single command line.	 The allowable
			     flags and their values are:

			     Allows use of the
				       option on a  command  (see  get(1))  to
				       create branch deltas.

			     The highest release (i.e., "ceiling"),
				       a  number  less	than or equal to 9999,
				       which can be retrieved by a command for
				       editing.	  The  default	value  for  an
				       unspecified flag is 9999.

			     The lowest release
				       (i.e., "floor"), a number greater  than
				       0  but  less  than  9999,  which may be
				       retrieved by  a	command	 for  editing.
				       The  default  value  for an unspecified
				       flag is 1.

			     The default delta number
				       SID  to	be  used  by  a	 command  (see
				       get(1)).

			     Causes the message:

				       issued  by  or to be treated as a fatal
				       error (see delta(1)).  In  the  absence
				       of  this	 flag,	the  message is only a
				       warning.	 The message is issued	if  no
				       SCCS   identification   keywords	  (see
				       get(1)) are found in the text retrieved
				       or stored in the SCCS file.  If a value
				       is supplied, the keywords must  exactly
				       match  the  given string.  However, the
				       string must contain a keyword, but must
				       not contain embedded newlines.

			     Allows concurrent
				       commands for editing on the same SID of
				       an SCCS	file.	This  allows  multiple
				       concurrent  updates to the same version
				       of the SCCS file.

				       Only one user  can  perform  concurrent
				       edits.	Access	by  multiple  users is
				       usually accomplished by using a	common
				       login  or  a  set  user ID program (see
				       chmod(1) and exec(2)).

			     A	       list of releases to which deltas can no
				       longer  be  made.   (A  against	one of
				       these locked releases fails).  The list
				       has the following syntax:

				       The character in the list is equivalent
				       to specifying for the named SCCS	 file.
				       Omitting any list is equivalent to

			     Causes    to create a null delta in each of those
				       releases being skipped (if any) when  a
				       delta is made in a new release (such as
				       when making delta 5.1 after delta  2.7,
				       release	3  and release 4 are skipped).
				       These null  deltas  serve  as  so  that
				       branch  deltas can be created from them
				       later.  The absence of this flag causes
				       skipped	releases  to be nonexistent in
				       the SCCS file, preventing branch deltas
				       from  being  created  from  them in the
				       future.

			     User-definable text substituted  for  all	occur‐
			     rences of the
				       keyword in SCCS file text retrieved by

			     The       module  name  of	 the SCCS file substi‐
				       tuted for all occurrences of  the  key‐
				       word  in SCCS file text retrieved by If
				       the flag is not	specified,  the	 value
				       assigned	 is  the name of the SCCS file
				       with the leading removed.

			     The       type of module in the SCCS file substi‐
				       tuted for all occurrences of keyword in
				       SCCS file text retrieved by

			     Causes    to prompt for Modification Request (MR)
				       numbers	as  the	 reason for creating a
				       delta.  The  optional  value  specifies
				       the  name  of  a	 (MR)  number validity
				       checking program (see  delta(1)).   (If
				       this  flag is set when creating an SCCS
				       file, the option must also be used even
				       if its value is null).

			     Causes    to  create  files  with execute permis‐
				       sions.

	      Causes removal (deletion) of the specified
			     flag from an SCCS file.  The option can be speci‐
			     fied  only	 when  processing existing SCCS files.
			     Several options can be supplied on a single  com‐
			     mand  line.   See	the  option for allowable flag
			     names.

			     A	     list of releases to be unlocked.  See the
				     option  for a description of the flag and
				     the syntax of a list.

	      A		     login name, or numerical HP-UX group  ID,	to  be
			     added to the list of users allowed to make deltas
			     (changes) to the SCCS file.  A group ID is equiv‐
			     alent  to	specifying  all	 login names common to
			     that group ID.  Several options can be used on  a
			     single command line.  As many logins or numerical
			     group IDs as desired can be on the list  simulta‐
			     neously.	If  the list of users is empty, anyone
			     can add deltas.  A login or group ID preceded  by
			     a denies permission to make deltas.

	      A		     login  name  or  numerical	 group ID to be erased
			     from the list of users  allowed  to  make	deltas
			     (changes)	to  the SCCS file.  Specifying a group
			     ID is equivalent to specifying  all  login	 names
			     common  to that group ID.	Several options can be
			     used on a single command line.

	      The	     comment text is inserted into the SCCS file as  a
			     comment for the initial delta in a manner identi‐
			     cal to that of delta(1).  Omission of the	option
			     results  in a default comment line being inserted
			     in the form:

			     The option is valid only if  the  and/or  options
			     are  specified  (i.e.,  a	new SCCS file is being
			     created).

	      The list of Modification Request
			     (MR) numbers is inserted into the	SCCS  file  as
			     the  reason  for creating the initial delta, in a
			     manner identical to delta(1).  The flag  must  be
			     set  and  the  (MR)  numbers are validated if the
			     flag has a value (the name of an (MR) number val‐
			     idation  program).	  Diagnostic messages occur if
			     the flag is not set or (MR) validation fails.

	      Causes	     to check the structure  of	 the  SCCS  file  (see
			     sccsfile(4)),  and	 to  compare  a newly computed
			     checksum (the sum of all of the characters in the
			     SCCS  file	 except	 those in the first line) with
			     the checksum that is stored in the first line  of
			     the SCCS file.  Appropriate error diagnostics are
			     produced.

			     This option inhibits writing on  the  file,  thus
			     canceling	the  effect  of any other options sup‐
			     plied, and therefore is only meaningful when pro‐
			     cessing existing files.

	      The SCCS file checksum is recomputed and stored
			     in the first line of the SCCS file (see above).

			     Note that use of this option on a truly corrupted
			     file can prevent future detection of the  corrup‐
			     tion.

   Access Control Lists (ACLs)
       Do not add optional ACL entries to SCCS files.  SCCS removes them, pos‐
       sibly causing unexpected and undesirable access modes.

EXTERNAL INFLUENCES
       For information about the UNIX standard environment, see standards(5).

   Environment Variables
       determines the interpretation of	 text  as  single-  and/or  multi-byte
       characters.

       determines the language in which messages are displayed.

       If  or  is  not	specified  in  the  environment or is set to the empty
       string, the value of is used as a default for each unspecified or empty
       variable.  If is not specified or is set to the empty string, a default
       of (see lang(5)) is used instead of If any  internationalization	 vari‐
       able  contains  an invalid setting, behaves as if all internationaliza‐
       tion variables are set to See environ(5).

   International Code Set Support
       Single-byte and multi-byte character code sets are supported.

DIAGNOSTICS
       Use sccshelp(1) for explanations.

WARNINGS
       Number of lines in a SCCS file cannot exceed 99,999 lines.   Each  line
       can be of characters in non-UNIX Standard environment and in UNIX Stan‐
       dard environment (see standards(5)), including the newline.

FILES
       The last component of all SCCS file names must be of the form New  SCCS
       files  are given mode 444 (see chmod(1)).  Write permission in the per‐
       tinent directory is required to create a file.  All writing done by  is
       to  a  temporary	 x-file, called (see get(1)), created with mode 444 if
       the command is creating a new SCCS file, or with the same mode  as  the
       SCCS file if it exists.	After successful execution of the SCCS file is
       removed (if it exists), and the x-file is renamed to the	 name  of  the
       SCCS file.  This ensures that changes are made to the SCCS file only if
       no errors occurred.

       It is recommended that directories containing SCCS files	 be  mode  755
       and  that  SCCS	files  themselves  be mode 444.	 The mode of any given
       directory allows only the owner to modify SCCS files contained in  that
       directory.  The mode of the SCCS files prevents any modification at all
       except by SCCS commands.

       If it should be necessary to patch an SCCS file	for  any  reason,  the
       mode  can  be  changed to 644 by the owner, thus allowing the use of or
       any other suitable editor.  The edited file should be processed	by  an
       to  check  for corruption followed by an to generate a proper checksum.
       Another is recommended to ensure the SCCS file is valid.

       also makes use of a transient lock file called which is used to prevent
       simultaneous  updates  to the SCCS file by different users.  See get(1)
       for further information.

SEE ALSO
       delta(1), ed(1), get(1),	 sccshelp(1),  prs(1),	what(1),  sccsfile(4),
       acl(5), standards(5).

STANDARDS CONFORMANCE
								      admin(1)
[top]

List of man pages available for HP-UX

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