HP-UX Reference (11i v1 05/09) - 1 User Commands A-M (vol 1)

admin(1) admin(1)

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 ﬁle cannot exceed 99,999 lines. Each line can be of

BUFSIZ-3 characters in

non-XPG4 environment and

LINE_MAX-3 in XPG4 environment, including the newline.

FILES

The last component of all SCCS ﬁle names must be of the form

s.ﬁlename. New SCCS ﬁles are given

mode 444 (see chmod(1)). Write permission in the pertinent directory is required to create a ﬁle. All writ-

ing done by

admin is to a temporary x-ﬁle, called

x.ﬁlename, (see get(1)), created with mode 444 if the

admin command is creating a new SCCS ﬁle, or with the same mode as the SCCS ﬁle if it exists. After

successful execution of admin, the SCCS ﬁle is removed (if it exists), and the x-ﬁle is renamed to the name

of the SCCS ﬁle. This ensures that changes are made to the SCCS ﬁle only if no errors occurred.

It is recommended that directories containing SCCS ﬁles be mode 755 and that SCCS ﬁles themselves be

mode 444. The mode of any given directory allows only the owner to modify SCCS ﬁles contained in that

directory. The mode of the SCCS ﬁles prevents any modiﬁcation at all except by SCCS commands.

If it should be necessary to patch an SCCS ﬁle for any reason, the mode can be changed to 644 by the

owner, thus allowing the use of vi or any other suitable editor. Care must be taken! The edited ﬁle should

always be processed by an

admin -h to check for corruption followed by an admin -z to generate a

proper checksum. Another

admin -h is recommended to ensure the SCCS ﬁle is valid.

admin also makes use of a transient lock ﬁle called z.ﬁlename), which is used to prevent simultaneous

updates to the SCCS ﬁle by different users. See get(1) for further information.