g

get(1)

get(1)

NAME

get - get a version of an SCCS ®le

SYNOPSIS

get [-rSID] [-ccutoff] [-e] [-b] [-ilist] [-xlist] [-k] [-l[p] ] [-p] [-s] [-m] [-n] [-g] [-t]

[-wstring] [-aseq-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 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 generated text is normally written into a ®le called the g-®lewhose name is derived from the SCCS ®le name by simply removing the s. 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

 

-eoption 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, -c7502is 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% 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 -eoption used in a get for a particu-

 

lar 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

-efor 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-®legenerated by get with an -eoption 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 -eoption.

 

 

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 -eoption is used.

-b

Used with the -eoption 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:

 

list ::= range ⏐ list, range

 

 

range ::= SID ⏐ SID - SID

 

Section 1−318

− 1 −

HP-UX Release 11i: December 2000