|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands sccs-admin(1)
NAME
sccs-admin, admin - create and administer SCCS history files
SYNOPSIS
/usr/ccs/bin/admin [-bhnz] [-a username | groupid] ... [-
d flag] ... [-e username | groupid] ... [ -f flag [value]]
... [ -i [filename ]] [-m mr-list] [-rrelease] [ -t
[description-file]] [ -y [comment]] s.filename...
DESCRIPTION
The admin command creates or modifies the flags and other
parameters of SCCS history files. Filenames of SCCS history
files begin with the `s.' prefix, and are referred to as
s.files, or ``history'' files.
The named s.file is created if it does not exist already.
Its parameters are initialized or modified according to the
options you specify. Parameters not specified are given
default values when the file is initialized, otherwise they
remain unchanged.
If a directory name is used in place of the s.filename argu-
ment, the admin command applies to all s.files in that
directory. Unreadable s.files produce an error. The use of
`-' as the s.filename argument indicates that the names of
files are to be read from the standard input, one s.file per
line.
OPTIONS
The following options are supported:
-a username | groupid
Adds a user name, or a numerical group ID, to the list
of users who may check deltas in or out. If the list is
empty, any user is allowed to do so.
-b
Forces encoding of binary data. Files that contain ASCII
NUL or other control characters, or that do not end with
a NEWLINE, are recognized as binary data files. The con-
tents of such files are stored in the history file in
encoded form. See uuencode(1C) for details about the
encoding. This option is normally used in conjunction
with -i to force admin to encode initial versions not
recognized as containing binary data.
SunOS 5.10 Last change: 30 Sep 2002 1
User Commands sccs-admin(1)
-d flag
Deletes the indicated flag from the SCCS file. The -d
option may be specified only for existing s.files. See
-f for the list of recognized flags.
-e username | groupid
Erases a user name or group ID from the list of users
allowed to make deltas.
-f flag [value]
Sets the indicated flag to the (optional) value speci-
fied. The following flags are recognized:
b Enables branch deltas. When b is
set, branches can be created
using the -b option of the SCCS
get command (see sccs-get(1)).
cceil Sets a ceiling on the releases
that can be checked out. ceil is
a number less than or equal to
9999. If c is not set, the ceil-
ing is 9999.
dsid Specifies the default delta
number, or SID, to be used by
an SCCS get command.
ffloor Sets a floor on the releases
that can be checked out. The
floor is a number greater than 0
but less than 9999. If f is not
set, the floor is 1.
i Treats the `No id keywords
(ge6)' message issued by an SCCS
SunOS 5.10 Last change: 30 Sep 2002 2
User Commands sccs-admin(1)
get or delta command as an error
rather than a warning.
j Allows concurrent updates.
la Locks the indicated list of
l release[, release...] releases against deltas. If a is
used, this flag locks out deltas
to all releases. An SCCS `get
-e' command fails when applied
against a locked release.
mmodule Supplies a value for the module
name to which the %M% keyword is
to expand. If the m flag is not
specified, the value assigned is
the name of the SCCS file with
the leading s. removed.
n Creates empty releases when
releases are skipped. These null
(empty) deltas serve as anchor
points for branch deltas.
qvalue Supplies a value to which the
%Q% keyword is to expand when a
read-only version is retrieved
with the SCCS get command.
snumber Specifies how many lines of code
are scanned for the SCCS key-
word.
ttype Supplies a value for the module
type to which the %Y% keyword is
to expand.
SunOS 5.10 Last change: 30 Sep 2002 3
User Commands sccs-admin(1)
v[program] Specifies a validation program
for the MR numbers associated
with a new delta. The optional
program specifies the name of an
MR number validity checking pro-
gram. If this flag is set when
creating an SCCS file, the -m
option must also be used, in
which case the list of MRs may
be empty.
y[value,[value]] Specifies the SCCS keywords to
be expanded. If no value is
specified, no keywords will be
expanded.
-h
Checks the structure of an existing s.file (see
sccsfile(4)), and compares a newly computed check-sum
with one stored in the first line of that file. -h inhi-
bits writing on the file and so nullifies the effect of
any other options.
-i[filename]
Initializes the history file with text from the indi-
cated file. This text constitutes the initial delta, or
set of checked-in changes. If filename is omitted, the
initial text is obtained from the standard input. Omit-
ting the -i option altogether creates an empty s.file.
You can only initialize one s.file with text using -i.
This option implies the -n option.
-m mr-list
Inserts the indicated Modification Request (MR) numbers
into the commentary for the initial version. When speci-
fying more than one MR number on the command line, mr-
list takes the form of a quoted, space-separated list. A
warning results if the v flag is not set or the MR vali-
dation fails.
SunOS 5.10 Last change: 30 Sep 2002 4
User Commands sccs-admin(1)
-n
Creates a new SCCS history file.
-rrelease
Specifies the release for the initial delta. -r may be
used only in conjunction with -i. The initial delta is
inserted into release 1 if this option is omitted. The
level of the initial delta is always 1. Initial deltas
are named 1.1 by default.
-t[description-file]
Inserts descriptive text from the file description-file.
When -t is used in conjunction with -n, or -i to ini-
tialize a new s.file, the description-file must be sup-
plied. When modifying the description for an existing
file: a -t option without a description-file removes the
descriptive text, if any; a -t option with a
description-file replaces the existing text.
-y[comment]
Inserts the indicated comment in the ``Comments:'' field
for the initial delta. Valid only in conjunction with -i
or -n. If -y option is omitted, a default comment line
is inserted that notes the date and time the history
file was created.
-z
Recomputes the file check-sum and stores it in the first
line of the s.file. Caution: It is important to verify
the contents of the history file (see sccs-val(1), and
the print subcommand in sccs(1)), since using -z on a
truly corrupted file may prevent detection of the error.
EXAMPLES
Example 1: Preventing SCCS keyword expansion
SunOS 5.10 Last change: 30 Sep 2002 5
User Commands sccs-admin(1)
In the following example, 10 lines of file will be scanned
and only the W,Y,X keywords will be interpreted:
example% sccs admin -fs10 file
example% sccs admin -fyW,Y,X file
example% get file
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of alias and unalias:
LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error occurred.
FILES
s.* history file
SCCS/s.* history file in SCCS subdirectory
z.* temporary lock file
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWsprot |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
SEE ALSO
sccs(1), sccs-cdc(1), sccs-delta(1), sccs-get(1), sccs-
help(1), sccs-rmdel(1), sccs-val(1), sccsfile(4),
SunOS 5.10 Last change: 30 Sep 2002 6
User Commands sccs-admin(1)
attributes(5), environ(5), standards(5)
DIAGNOSTICS
Use the SCCS help command for explanations (see sccs-
help(1)).
WARNINGS
The last component of all SCCS filenames must have the `s.'
prefix. New SCCS files are given mode 444 (see chmod(1)).
All writing done by admin is to a temporary file with an x.
prefix, created with mode 444 for a new SCCS file, or with
the same mode as an existing SCCS file. After successful
execution of admin, the existing s.file is removed and
replaced with the x.file. This ensures that changes are made
to the SCCS file only when no errors have occurred.
It is recommended that directories containing SCCS files
have permission mode 755, and that the s.files themselves
have mode 444. The mode for directories allows only the
owner to modify the SCCS files contained in the directories,
while the mode of the s.files prevents all modifications
except those performed using SCCS commands.
If it should be necessary to patch an SCCS file for any rea-
son, the mode may be changed to 644 by the owner to allow
use of a text editor. However, extreme care must be taken
when doing this. The edited file should always be processed
by an `admin -h' command to check for corruption, followed
by an `admin -z' command to generate a proper check-sum.
Another `admin -h' command is recommended to ensure that the
resulting s.file is valid.
admin also uses a temporary lock s.file, starting with the
`z.' prefix, to prevent simultaneous updates to the s.file.
See sccs-get(1) for further information about the `z.file'.
SunOS 5.10 Last change: 30 Sep 2002 7
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:24:23 GMT 2007
|
Your favourite pages:
No pages logged yet... Top 10 most popular pages:
prstat man page (24546 hits)
(Solaris 10 11_06)
netcat man page (17695 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (13530 hits)
(Solaris 10 11_06)
signal man page (12550 hits)
(Suse Linux 10.1)
startproc man page (11991 hits)
(Suse Linux 10.1)
raidctl man page (11357 hits)
(Solaris 10 11_06)
adv_cap_autoneg man page (10285 hits)
(Solaris 10 11_06)
sqlite3 man page (9729 hits)
(openSUSE 10.2)
CPAN man page (8947 hits)
(Suse Linux 10.1)
BusyBox man page (7702 hits)
(Suse Linux 10.1)
|
Man Pages 
