get.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

get(1) get(1)

NAME

get - get a version of an SCCS ﬁle

SYNOPSIS

get [-r SID][-c

cutoff][-e][-b][-i list ][

-x list ][-k][-l[p]] [

-p][-s][-m][-n][-g

][-t]

[

-w string ][-a

seq-number ] ﬁle ...

DESCRIPTION

The

get command generates an ASCII text ﬁle from each named SCCS ﬁle according to the speciﬁcations

given by its option arguments, which begin with

-. The arguments can be speciﬁed in any order, but all

option arguments apply to all named SCCS ﬁles. If a directory is named,

get behaves as if each ﬁle in

the directory was speciﬁed as a named ﬁle, except that non-SCCS ﬁles (last component of the path name

does not begin with

s.) and unreadable ﬁles are silently ignored. If a ﬁle name of

- is given, the stan-

dard 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 generated text is normally written into a ﬁle called the g-ﬁle whose name is derived from the SCCS

ﬁle name by simply removing the

preﬁx (see FILES below).

Options

Explanation of the option arguments below is based on processing only one SCCS ﬁle. When processing

multiple SCCS ﬁles, the effects of any option argument applies independently to each named ﬁle.

-rSID The SCCS IDentiﬁcation string (SID) of the version (delta) of an SCCS ﬁle to be

retrieved. Table 1 shows, for the most useful cases, which version of an SCCS ﬁle is

retrieved (as well as the SID of the version to be eventually created by delta if the

-e option is also used), as a function of the SID speciﬁed (see delta (1)).

-ccutoff cutoff date-time, in the form:

YY[MM[DD[HH[MM[SS]]]]]

No changes (deltas) to the SCCS ﬁle which were created after the speciﬁed cutoff

date-time are included in the generated ASCII text ﬁle. Units omitted from the

date-time default to their maximum possible values; that is,

-c7502 is equivalent

to -c750228235959. Any number of non-numeric characters can separate the

various 2-digit pieces of the cutoff date-time. This feature allows one to specify a

cutoff date in the form: -c77/2/2 9:22:25. Note that this implies that one can

use the %E% and %U% identiﬁcation keywords (see below) for nested gets within a

command:

~!get "-c%E% %U%" s.file

-e Indicates that the get is for the purpose of editing or making a change (delta) to

the SCCS ﬁle via a subsequent use of delta. The -e option used in a

get for a

particular version (SID) of the SCCS ﬁle prevents further

gets for editing on the

same SID until delta is executed or the j (joint edit) ﬂag is set in the SCCS ﬁle

(see admin(1)). Concurrent use of get -e for different SIDs is always allowed.

Note, however, that only one user is permitted to do a concurrent get -e (see

admin(1)).

If the g-ﬁle generated by

get with an -e option is accidentally ruined in the pro-

cess of editing it, it can be regenerated by re-executing the get command with the

-k option in place of the -e option.

SCCS ﬁle protection speciﬁed via the ceiling, ﬂoor, and authorized user list stored

in the SCCS ﬁle (see admin(1)) are enforced when the

-e option is used.

-b Used with the -e option to indicate that the new delta should have an SID in a new

branch as shown in Table 1. This option is ignored if the b ﬂag is not present in the

ﬁle (see admin(1)) or if the retrieved delta is not a leaf delta . (A leaf delta is one

that has no successors on the SCCS ﬁle tree.)

Note: A branch delta can always be created from a non-leaf delta .

-ilist A list of deltas to be included (forced to be applied) in the creation of the generated

ﬁle. The list has the following syntax:

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

Summary of content (6 pages)

PAGE 1
get(1) get(1) NAME get - get a version of an SCCS file SYNOPSIS get [-r SID] [-c cutoff] [-e] [-b] [-i list ] [-x list ] [-k] [-l[p] ] [-p] [-s] [-m] [-n] [-g] [-t] [-w string ] [-a seq-number ] file ... DESCRIPTION The get command generates an ASCII text file from each named SCCS file according to the specifications given by its option arguments, which begin with -. The arguments can be specified in any order, but all option arguments apply to all named SCCS files.
PAGE 2
get(1) get(1) list ::= range  list, range range ::= SID  SID - SID SID, the SCCS Identification of a delta, can be in any form shown in the "SID Specified" column of Table 1. Partial SIDs are interpreted as shown in the "SID Retrieved" column of Table 1. See WARNINGS. A gA -xlist A list of deltas to be excluded (forced not to be applied) in the creation of the generated file. See the -i option for the list format.
PAGE 3
get(1) get(1) Table 1. Determination of SCCS Identification String SID* − b Option Specified Used % Other Conditions SID Retrieved SID of Delta to be Created none %% none %% no yes R defaults to mR R defaults to mR mR.mL mR.mL mR.(mL+1) mR.mL.(mB+1).1 R R R R R no no yes yes - mR.mL mR.mL mR.mL mR.mL hR.mL** R.1*** mR.(mL+1) mR.mL.(mB+1).1 mR.mL.(mB+1).1 hR.mL.(mB+1).1 R - R > mR R = mR R > mR R = mR R < mR and R does not exist Trunk succ. in release > R and R exists R.mL R.L R.L R.
PAGE 4
get(1) A gA get(1) %R% Release. %L% Level. %B% Branch. %S% Sequence. %D% Current date (YY/MM/DD). %H% Current date (MM/DD/YY). %T% Current time (HH:MM:SS). %E% Date newest applied delta was created (YY/MM/DD). %G% Date newest applied delta was created (MM/DD/YY). %U% Time newest applied delta was created (HH:MM:SS). %Y% Module type: value of the t flag in the SCCS file (see admin (1)). %F% SCCS file name. %P% Fully qualified SCCS file name.
PAGE 5
get(1) get(1) files are named by replacing the leading s with the tag. The g-file is an exception to this scheme: the gfile is named by removing the s. prefix. For example, s.xyz.c, the auxiliary file names would be xyz.c, l.xyz.c, p.xyz.c, and z.xyz.c, respectively. The g-file , which contains the generated text, is created in the current directory (unless the -p option is used). A g-file is created in all cases, whether or not any lines of text were generated by the get. It is owned by the real user.
PAGE 6
(Notes) A (Notes) gA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010