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

g
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. If a directory is named,
get behaves as if each file in the
directory was specified as a named file, except that non-SCCS files (last component of the path name does
not begin with
s.) and unreadable files are silently ignored. If a file 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 generated text is normally written into a file called the g-file whose name is derived from the SCCS file
name by simply removing the
s. prefix (see FILES below).
Options
Explanation of the option arguments below is based on processing only one SCCS file. When processing
multiple SCCS files, the effects of any option argument applies independently to each named file.
-rSID The SCCS IDentification string (SID) of the version (delta) of an SCCS file to be
retrieved. Table 1 shows, for the most useful cases, which version of an SCCS file 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 specified (see delta(1)).
-ccutoff cutoff date-time, in the form:
YY[MM[DD[HH[MM[SS]]]]]
No changes (deltas) to the SCCS file which were created after the specified cutoff
date-time are included in the generated ASCII text file. 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 vari-
ous 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% identification 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 file via a subsequent use of delta. The -e option used in a
get for a particu-
lar version (SID) of the SCCS file prevents further
gets for editing on the same SID
until delta is executed or the j (joint edit) flag is set in the SCCS file (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-file generated by
get with an -e option is accidentally ruined in the process
of editing it, it can be regenerated by re-executing the get command with the -k
option in place of the -e option.
SCCS file protection specified via the ceiling, floor, and authorized user list stored in
the SCCS file (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 flag is not present in the
file (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 file 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
file. The list has the following syntax:
list ::= range  list, range
range ::= SID  SID - SID
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−329