admin.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

admin(1) admin(1)

NAME

admin - create and administer SCCS ﬁles

SYNOPSIS

admin -i[name] [-n][

-b][-a login] ... [-d ﬂag[ﬂag-val ] ] ... [

-f ﬂag[ﬂag-val ] ] ...

[

-m mrlist ] ... [-r

rel][-t[name]] [-y[comment]] ﬁle ...

admin -n [-a login ] ... [

-d ﬂag[ﬂag-val ] ] ... [-f ﬂag[ﬂag-val ] ] ... [

-m mrlist ] ...

[

-t[name]] [

-y[comment]] ﬁle ...

admin [-a login ] ... [-e

[

-r rel][-t[name]] ﬁle ...

admin -h ﬁle ...

admin -z ﬁle ...

DESCRIPTION

The

admin command is used to create new SCCS ﬁles and change the parameters of existing ones. Argu-

ments to admin, which may appear in any order, ( unless

-- is speciﬁed as an argument, in which case

all arguments after

-- are treated as ﬁles ) consist of option arguments, beginning with

-, and named

ﬁles (note that SCCS ﬁle names must begin with the characters

s.). If a named ﬁle does not exist, it is

created and its parameters are initialized according to the speciﬁed option arguments. Parameters not

initialized by an option argument are assigned a default value. If a named ﬁle does exist, parameters

corresponding to speciﬁed option arguments are changed, and other parameters are left unaltered.

If directory is named instead of ﬁle,

admin acts on each ﬁle in directory , except that non-SCCS ﬁles (the

last component of the path name does not begin with

s.) and unreadable ﬁles 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 ﬁle to be processed. Again, non-SCCS ﬁles and unreadable ﬁles are silently ignored.

The

admin option arguments apply independently to all named ﬁles, whether one ﬁle or many. In the

following discussion, each option is explained as if only one ﬁle is speciﬁed, although they affect single or

multiple ﬁles identically.

Options

The

admin command supports the following options and command-line arguments:

-n This option indicates that a new SCCS ﬁle is to be created.

-i[name] The name of a ﬁle from which the contents for a new SCCS ﬁle is to be taken. (if

name is a binary ﬁle, then you must specify the -b option) The contents constitutes

the ﬁrst delta of the ﬁle (see the -r option for the delta numbering scheme). If the

-i option is used but the ﬁle name is omitted, the text is obtained by reading the

standard input until an end-of-ﬁle is encountered. If this option is omitted, the

SCCS ﬁle is created with an empty initial delta. Only one SCCS ﬁle can be created

by an admin command on which the -i option is supplied. Using a single admin

to create two or more SCCS ﬁles requires that they be created empty (no -i option).

Note that the -i option implies the -n option.

-b Encode the contents of name, speciﬁed to the -i option. This keyletter must be

used if name is a binary ﬁle; otherwise, a binary ﬁle 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 ﬁle from which descriptive text for the SCCS ﬁle is to be taken. If

the -t option is used and admin is creating a new SCCS ﬁle (the -n and/or -i

options are also used), the descriptive text ﬁle name must also be supplied. In the

case of existing SCCS ﬁles:

• A

-t option without a ﬁle name causes removal of descriptive text (if any)

currently in the SCCS ﬁle.

• A

-t option with a ﬁle name causes text (if any) in the named ﬁle to replace the

descriptive text (if any) currently in the SCCS ﬁle.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
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 ... A admin -h file ...
PAGE 2
admin(1) -f flag A aA admin(1) This option specifies a flag, and possibly a value for the flag, to be placed in the SCCS file. Several -f options can be supplied on a single admin command line. The allowable flags and their values are: b Allows use of the -b option on a get command (see get (1)) to create branch deltas. cceil The highest release (i.e., "ceiling"), a number less than or equal to 9999, which can be retrieved by a get command for editing.
PAGE 3
admin(1) -d flag admin(1) v[pgm] Causes delta 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 m option must also be used even if its value is null). x Causes get to create files with execute permissions. Causes removal (deletion) of the specified flag from an SCCS file.
PAGE 4
admin(1) admin(1) If LC_CTYPE or LC_MESSAGES is not specified in the environment or is set to the empty string, the value of LANG is used as a default for each unspecified or empty variable. If LANG is not specified or is set to the empty string, a default of C (see lang (5)) is used instead of LANG. If any internationalization variable contains an invalid setting, admin behaves as if all internationalization variables are set to C. See environ (5).