Command Reference Guide

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/!!!intro.1
________________________________________________________________
___ ___
a
admin(1) admin(1)
NAME
admin - create and administer SCCS files
SYNOPSIS
admin -i[name] [-n][-b][-a login] ... [-d flag[flag-val]] ... [-f flag[flag-val]] ...
[-m mrlist] ... [-r rel][-t[name]] [-y[comment]] file ...
admin -n [-a login] ... [-d flag[flag-val]] ... [-f flag[flag-val]] ... [-m mrlist] ...
[-t[name]] [-y[comment]] file ...
admin [-a login] ... [-e login] ... [-d flag[flag-val]] ... [-m mrlist] ...
[-r rel][-t[name]] file ...
admin -h file ...
admin -z file ...
DESCRIPTION
The admin command is used to create new SCCS files and change the parameters of existing ones. Argu-
ments to admin, 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
s.). 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,
admin acts on each file in directory, except that non-SCCS files (the
last component of the path name does not begin with
s.) 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 admin option arguments apply independently to all named files, whether one file or many. In the fol-
lowing discussion, each option is explained as if only one file is specified, although they affect single or mul-
tiple files identically.
Options
The
admin command supports the following options and command-line arguments:
-n This option indicates that a new SCCS file is to be created.
-i[name] 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 -r option for the delta numbering scheme). If the -i
option
is used but the file name is omitted, 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
admin com-
mand on which the -i option is supplied. Using a single admin to create two or
more SCCS files requires that they be created empty (no -i option). Note that the -
i
option implies the -n option.
-b Encode the contents of name, specified to the -i option. This keyletter must be used
if name is a binary file; otherwise, a binary file will not be handled properly by SCCS
commands.
-r rel The release (rel) into which the initial delta is inserted. This option can be used only
if the -i option is also used. If the -r option is not used, the initial delta is inserted
into release 1. The level of the initial delta is always 1 (by default initial deltas are
named 1.1).
-t[name] The name of a file from which descriptive text for the SCCS file is to be taken. If the
-t option is used and admin is creating a new SCCS file (the -n and/or -i options
are also used), the descriptive text file name must also be supplied. In the case of
existing SCCS files:
• A -t option without a file name causes removal of descriptive text (if any)
currently in the SCCS file.
• A -t 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.
HP-UX Release 11i: December 2000 − 1 − Section 1−−13
___
___