User Commands                                         sccs-get(1)


NAME

     sccs-get, get - retrieve a version of an SCCS file


SYNOPSIS

     /usr/ccs/bin/get [-beFgkmnopst] [-l [p]] [-asequence]
         [-c date-time | -cdate-time] [-Gg-file] [-w%W%-string]
         [-i sid-list | -isid-list] [-q[nsedelim]] [-r [sid]]
         [-x sid-list | -xsid-list] [-z[cmr]]
         [-Nbulk-spec] s.filename...

     /usr/xpg4/bin/get [-beFgkmnopst] [-l [p]] [-asequence]
         [-c date-time | -cdate-time] [-Gg-file] [-w%W%-string]
         [-i sid-list | -isid-list] [-q[nsedelim]] [-r sid | -rsid]
         [-x sid-list | -xsid-list] [-z[cmr]]
         [-Nbulk-spec] s.filename...


DESCRIPTION

     The get utility retrieves a working copy from the SCCS  his-
     tory file, according to the specified options.

     For each s.filename argument, get displays the   SCCS  delta
     ID (SID) and number of lines retrieved.

     If a directory name is used in place of the s.filename argu-
     ment,  the get command applies to all s.files in that direc-
     tory. Unreadable s.files produce an error;  processing  con-
     tinues  with  the  next file (if any). 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.

     The retrieved file normally has the same  filename  base  as
     the  s.file,  less the prefix, and is  referred to as the g-
     file.

     For each file processed, get responds (on the standard  out-
     put)  with  the  SID  being accessed, and with the number of
     lines retrieved from the s.file.


OPTIONS

     The following options are supported:

     -A           Annotates the output. Precedes each  line  with
                  the  programmer  who last changed that line and
                  the related date. This option may  be  combined

SunOS 5.11           Last change: 2015/04/29                    1


User Commands                                         sccs-get(1)

                  with the options -m and -n.  When combined with
                  other annotate options, the text related to  -A
                  is  inserted  last.   Future versions of get(1)
                  may add support for a parameter to this  option
                  that implements some of the prs -d data specs.

                  This option is a SCHILY extension that does not
                  exist in historic sccs implementations.

     -asequence   Retrieves  the  version  corresponding  to  the
                  indicated  delta  sequence number.  This option
                  is used primarily by the SCCS comb command (see
                  sccs-comb(1)).   For users, -r is an easier way
                  to specify a version. The -a option  supersedes
                  the -r option when both are used.

     -b           Creates a new branch. Used with the  -e  option
                  to  indicate  that  the new delta should have a
                  SID in a new branch.  Instead  of  incrementing
                  the  level  for  version  to be checked in, get
                  indicates in the p.file that the  delta  to  be
                  checked  in  should  either  initialize  a  new
                  branch and sequence (if there  is  no  existing
                  branch  at the current level), or increment the
                  branch component of the SID.  If the b flag  is
                  not set in the s.file, this option is ignored.

     -c date-time

     -cdate-time  Retrieves the latest version checked  in  prior
                  to the date and time indicated by the date-time
                  argument.  date-time takes the form:

                   yy[mm[dd[ hh[mm[ss]]]]]

                  Units omitted from the indicated date and  time
                  default  to their maximum possible values; that
                  is  -c7502  is  equivalent  to  -c750228235959.
                  Values  of  yy  in the range 69-99 refer to the
                  twentieth century. Values in  the  range  00-68
                  refer  to the twenty-first century.  Any number
                  of  non-numeric  characters  may  separate  the
                  various  2  digit  components.  If  white-space
                  characters occur, the  date-time  specification
                  must be quoted.

                  A date-time specification in the form:

SunOS 5.11           Last change: 2015/04/29                    2


User Commands                                         sccs-get(1)

                   yyyy/[mm[dd[hh[mm[ss]]]]]

                  refers to a 4-digit year and allows to  specify
                  a year outside the range 1969-2068.

     -e           Retrieves a  version  for  editing.  With  this
                  option,  get  places  a  lock on the s.file, so
                  that no one else can check in  changes  to  the
                  version  you have checked out. If the j flag is
                  set in the s.file, the lock is  advisory:   get
                  issues  a  warning  message.  Concurrent use of
                  `get -e' for different SIDs  is  allowed.  How-
                  ever,  get  will not check out a version of the
                  file if a writable version is  present  in  the
                  directory.  All SCCS file protections stored in
                  the  s.file,  including  the  release  ceiling,
                  floor, and authorized user list, are honored by
                  `get -e'.

     -F           Enforce to retrieve the g.file even  if  a  SID
                  specific checksum missmatch has been detected.

     -g           Gets the SCCS version  ID,  without  retrieving
                  the   version   itself.   Used  to  verify  the
                  existence of a particular SID.

     -Gnewname    Uses newname as the name of the retrieved  ver-
                  sion.

     -i sid-list

     -isid-list   Specifies a list of deltas to  include  in  the
                  retrieved  version.  The  included  deltas  are
                  noted in the standard output message.  sid-list
                  is  a comma-separated list of SIDs.  To specify
                  a range of deltas, use a `-' separator  instead
                  of a comma, between two SIDs in the list.

     -k           Suppresses expansion of  ID  keywords.   -k  is
                  implied by the -e.

     -l[p]        Retrieves a summary of the delta table (version
                  log)  and  write it to a listing file, with the
                  `l.'  prefix (called `l.file').   When  -lp  is
                  used,  write  the  summary  onto  the  standard

SunOS 5.11           Last change: 2015/04/29                    3


User Commands                                         sccs-get(1)

                  output.

     -L           Treated as if -lp was given.

     -m           Precedes each retrieved line with  the  SID  of
                  the  delta  in  which it was added to the file.
                  The SID is separated from the line with a TAB.

     -Nbulk-spec  Processes a bulk of SCCS history  files.   This
                  option  allows to do an efficient mass process-
                  ing of SCCS history files.

                  The bulk-spec parameter  is  composed  from  an
                  optional list of flag parameters followed by an
                  optional path specifier.

                  The following flag types are supported:

                  ++        If bulk-spec is preceded by  a  `++',
                            get(1)  expects  to process filenames
                            that are prepended by  a  plus  sign,
                            the related SID and another plus sign
                            following the form:

                                +sid+filename

                            This  permits   each   file   to   be
                            retrieved with an individual SID.

                  The following path  specifier  types  are  sup-
                  ported:

                  -N        The file name parameters to  the  get
                            command  are not s.filename files but
                            the  names  of  the   g-files.    The
                            s.filename  names  are  automatically
                            derived  from  the  g-file  names  by
                            prepending  s.  to the last path name
                            component.

                  -Ns.      The file name parameters to  the  get
                            command  are  s.filename  files.  The
                            the g-files names  are  automatically
                            derived   by  removing  s.  from  the
                            beginning of last path name component
                            of the s.filename.

                  -Ndir     The file name parameters to  the  get

SunOS 5.11           Last change: 2015/04/29                    4


User Commands                                         sccs-get(1)

                            command  are not s.filename files but
                            the  names  of  the   g-files.    The
                            s.filename  names are put into direc-
                            tory dir, the names are automatically
                            derived  from  the  g-file  names  by
                            prepending dir/s.  to the  last  path
                            name component.

                  -Ndir/s.  The file name parameters to  the  get
                            command   are   s.filename  files  in
                            directory dir.  The the g-files names
                            are automatically derived by removing
                            dir/s.  from the  beginning  of  last
                            path    name    component    of   the
                            s.filename.

                  A typical value for dir is SCCS.

                  In order to  overcome  the  limited  number  of
                  exec(2) arguments, it is recommended to use `-'
                  as the file name parameter for  get(1)  and  to
                  send a list of path names to stdin.

                  This option is a SCHILY extension that does not
                  exist in historic sccs implementations.

     -n           Precedes each line with the %M% ID keyword  and
                  a  TAB.  When  both  the  -m and -n options are
                  used, the ID keyword precedes the SID, and  the
                  line of text.

     -o           Retrieves the file under the original  time  of
                  the requested version.

                  Use this option with care, as it may be in con-
                  flict  with  make(1) rules. Using `get -o' thus
                  may cause make to perform an automatic retrival
                  of  the  latest  version as the s.file is newer
                  than the gotten file, or cause make to skip the
                  compilation   as   the  compilation  result  is
                  already newer than the gotten file.

                  This option is a SCHILY extension that does not
                  exist in historic sccs implementations.

     -p           Writes the text of the retrieved version to the
                  standard  output. All messages that normally go
                  to the standard output are written to the stan-
                  dard error instead.

SunOS 5.11           Last change: 2015/04/29                    5


User Commands                                         sccs-get(1)

     -q[nsedelim] Enable NSE  mode.   If  NSE  mode  is  enabled,
                  several NSE related extensions may be used.  In
                  this release, the value of nsedelim is ignored.

                  In NSE mode, get never issues a  warning  about
                  missing id keywords.

                  This option is an  undocumented  SUN  extension
                  that  does not exist in historic sccs implemen-
                  tations.

     -s           Suppresses all output normally written  on  the
                  standard  output. However, fatal error messages
                  (which always go to the standard error)  remain
                  unaffected.

     -t           Retrieves the most recently created (top) delta
                  in a given release (for example:  -r1).

     -w%W%-string The %W%-string is used as a replacement for the
                  %W%  keyword.   If -w was not specified, %W% is
                  expanded to %Z%%M%  %I%, otherwise the argument
                  from -w is used.

                  This option is an  undocumented  SUN  extension
                  that  does not exist in historic sccs implemen-
                  tations.

     -z[cmr]      Append MR number to CMR  list  for  CMF  exten-
                  sions.

                  This option is an  undocumented  SUN  extension
                  that  does not exist in historic sccs implemen-
                  tations.

     -Cdir        Specify the base directory for the g-file rela-
                  tive  to  the  current  working  directory.  By
                  default, the g-file is created in  the  current
                  directory (independent from the location of the
                  s.file.

     -V           Prints  the  get  version  number  string   and
                  exists.

SunOS 5.11           Last change: 2015/04/29                    6


User Commands                                         sccs-get(1)

  /usr/ccs/bin/get
     -d           Do not print the number of gotten lines.

                  This option is an  undocumented  SUN  extension
                  that  does not exist in historic sccs implemen-
                  tations.

     -r[sid]      Retrieves  the  version  corresponding  to  the
                  indicated SID (delta).

                  The SID for a given delta is a number, in Dewey
                  decimal format, composed of two or four fields:
                  the release and level fields,  and  for  branch
                  deltas,  the  branch  and sequence fields.  For
                  instance, if 1.2 is the SID, 1 is the  release,
                  and  2  is the level number.  If 1.2.3.4 is the
                  SID, 3 is the branch  and  4  is  the  sequence
                  number.

                  You need not specify the entire SID to retrieve
                  a  version  with  get.   When you omit -r alto-
                  gether, or  when  you  omit  both  release  and
                  level,   get  normally  retrieves  the  highest
                  release and level.  If the d flag is set to  an
                  SID  in  the  s.file  and you omit the SID, get
                  retrieves the default version indicated by that
                  flag.

                  When you specify a release but omit the  level,
                  get   retrieves   the  highest  level  in  that
                  release. If that release does  not  exist,  get
                  retrieves  highest  level from the next-highest
                  existing release.

                  Similarly  with  branches,  if  you  specify  a
                  release,  level  and  branch, get retrieves the
                  highest sequence in that branch.

     -x sid-list

     -x[sid-list] Excludes  the   indicated   deltas   from   the
                  retrieved  version.  The  excluded  deltas  are
                  noted in the standard output message.  sid-list
                  is  a comma-separated list of SIDs.  To specify
                  a range of deltas, use a `-' separator  instead
                  of a comma, between two SIDs in the list.

  /usr/xpg4/bin/get

SunOS 5.11           Last change: 2015/04/29                    7


User Commands                                         sccs-get(1)

     -r sid

     -rsid        Same as for /usr/ccs/bin/get except that SID is
                  mandatory.

     -x sid-list

     -xsid-list   Same as for /usr/ccs/bin/get except  that  sid-
                  list is mandatory.


OUTPUT

  /usr/ccs/bin/get
     The output format for /usr/ccs/bin/get is as follows:

       "%s\n%d lines\n", <SID>, <number of lines>

  /usr/xpg4/bin/get
     The output format for /usr/xpg4/bin/get is as follows:

       "%s\n%d\n", <SID>, <number of lines>


USAGE

     Usage guidelines are as follows:

  ID Keywords
     In the absence of -e or -k, get  expands  the  following  ID
     keywords  by replacing them with the indicated values in the
     text of the retrieved source.

SunOS 5.11           Last change: 2015/04/29                    8


User Commands                                         sccs-get(1)

SunOS 5.11           Last change: 2015/04/29                    9


User Commands                                         sccs-get(1)

     ____________________________________________________________
      Keyword                         Value
     ____________________________________________________________
      %A%        Shorthand notation for an ID line with data for
                 what(1): %Z%%Y%  %M%  %I%%Z%
     ____________________________________________________________
      %B%        SID branch component
     ____________________________________________________________
      %C%        Current line number. Intended  for  identifying
                 messages  output  by the program such as ``this
                 shouldn't have happened'' type errors.   It  is
                 not  intended  to be used on every line to pro-
                 vide sequence numbers.
     ____________________________________________________________
      %D%        Current date: yy/mm/dd
     ____________________________________________________________
      %d%        Current date: yyyy/mm/dd
     ____________________________________________________________
      %E%        Date newest applied delta was created: yy/mm/dd
     ____________________________________________________________
      %e%        Date  newest   applied   delta   was   created:
                 yyyy/mm/dd
     ____________________________________________________________
      %F%        SCCS s.file name
     ____________________________________________________________
      %G%        Date newest applied delta was created: mm/dd/yy
     ____________________________________________________________
      %g%        Date  newest   applied   delta   was   created:
                 mm/dd/yyyy
     ____________________________________________________________
      %H%        Current date: mm/dd/yy
     ____________________________________________________________
      %h%        Current date: mm/dd/yyyy
     ____________________________________________________________
      %I%        SID of the retrieved version: %R%.%L%.%B%.%S%
     ____________________________________________________________
      %L%        SID level component
     ____________________________________________________________
      %M%        Module name: either the value of the m flag  in
                 the  s.file (see sccs-admin(1)), or the name of
                 the s.file less the prefix
     ____________________________________________________________
      %P%        Fully qualified s.file name
     ____________________________________________________________
      %Q%        Value of the q flag in the s.file
     ____________________________________________________________
      %R%        SID Release component
     ____________________________________________________________
      %S%        SID Sequence component
     ____________________________________________________________
      %T%        Current time: hh:mm:ss
     ____________________________________________________________

SunOS 5.11           Last change: 2015/04/29                   10


User Commands                                         sccs-get(1)

      %U%        Time the  newest  applied  delta  was  created:
    |         |  hh:mm:ss                                       |
    |_________|_________________________________________________|
    | %W%     |  Shorthand notation for an ID line with data for|
    |         |  what: %Z%%M%  %I% or get -w argument           |
    |_________|_________________________________________________|
    | %Y%     |  Module type: value of the t flag in the s.file |
    |_________|_________________________________________________|
    | %Z%     |  4-character string: `@(#)', recognized by what |
    |_________|_________________________________________________|

     A line with a string in the form %sccs.include.filename%  is
     replaced  by  the content of the file filename.  The file is
     searched for in the path list found in the environment vari-
     able SCCS_INCLUDEPATH.

     The keywords %d%, %e%, %g% and  %h%  are  only  expanded  if
     either  the `x' flag has been set by the admin(1) command or
     if the expansion for a specific keyword has been enabled via
     the `y' flag.

  ID String
     The table below explains how the  SCCS identification string
     is  determined for retrieving and creating deltas.

SunOS 5.11           Last change: 2015/04/29                   11


User Commands                                         sccs-get(1)

     _______________________________________________________________________
    |              Determination of SCCS Identification String             |
    |___________|___________|__________________|___________|_______________|
    |  SID (1)  | -b Option |      Other       |    SID    |  SID of Delta |
    | Specified | Used (2)  |    Conditions    | Retrieved | to be Created |
    |___________|___________|__________________|___________|_______________|
    | none (3)  | no        | R defaults to mR | mR.mL     | mR.(mL+1)     |
    | none (3)  | yes       | R defaults to mR | mR.mL     | mR.mL.(mB+1).1|
    | R         | no        | R > mR           | mR.mL     | R.1 (4)       |
    | R         | no        | R = mR           | mR.mL     | mR.(mL+1)     |
    | R         | yes       | R > mR           | mR.mL     | mR.mL.(mB+1).1|
    | R         | yes       | R = mR           | mR.mL     | mR.mL.(mB+1).1|
    | R         | -         | R  <  mR  and  R | hR.mL (5) | hR.mL.(mB+1).1|
    |           |           | does not exist   |           |               |
    | R         | -         | Trunk succ.  (6) | R.mL      | R.mL.(mB+1).1 |
    |           |           | in  release  > R |           |               |
    |           |           | and R exists     |           |               |
    | R.L       | no        | No trunk succ.   | R.L       | R.(L+1)       |
    | R.L       | yes       | No trunk succ.   | R.L       | R.L.(mB+1).1  |
    | R.L       | -         | Trunk  succ.  in | R.L       | R.L.(mB+1).1  |
    |           |           | release > R      |           |               |
    | R.L.B     | no        | No branch succ.  | R.L.B.mS  | R.L.B.(mS+1)  |
    | R.L.B     | yes       | No branch succ.  | R.L.B.mS  | R.L.(mB+1).1  |
    | R.L.B.S   | no        | No branch succ.  | R.L.B.S   | R.L.B.(S+1)   |
    | R.L.B.S   | yes       | No branch succ.  | R.L.B.S   | R.L.(mB+1).1  |
    | R.L.B.S   | -         | Branch succ.     | R.L.B.S   | R.L.(mB+1).1  |
    |___________|___________|__________________|___________|_______________|

     (1)  `R', `L', `B', and  `S'  are  the  `release',  `level',
          `branch', and `sequence' components of the SID, respec-
          tively; `m' means `maximum'. Thus, for example,  `R.mL'
          means  `the  maximum  level  number  within release R';
          `R.L.(mB+1).1' means `the first sequence number on  the
          new branch (that is, maximum branch number plus one) of
          level L within release R'.  Note: If the SID  specified
          is  of  the  form `R.L', `R.L.B', or `R.L.B.S', each of
          the specified components must exist.

     (2)  The -b option is  effective  only  if  the  b  flag  is
          present   in   the   file.   An   entry  of  `-'  means
          `irrelevant'.

     (3)  This case applies if the d (default SID)  flag  is  not
          present  in  the file.  If the d flag is present in the
          file, the SID obtained from the d flag  is  interpreted
          as  if it had been specified on the command line. Thus,
          one of the other cases in this table applies.

SunOS 5.11           Last change: 2015/04/29                   12


User Commands                                         sccs-get(1)

     (4)  Forces creation of the first delta in a new release.

     (5)  `hR' is the highest existing release that is lower than
          the specified, nonexistent, release R.

     (6)  Successor.


ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables  that  affect  the  execution  of  get(1):   LANG,
     LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES, and NLSPATH.

     SCCS_INCLUDEPATH
          A colon separated list of directories where to look for
          include  files  for  a %sccs.include.filename% replace-
          ment.

     SCCS_NO_HELP
          If set, get(1) will not automatically call help(1) with
          the  SCCS  error  code in order to print a more helpful
          error message. Scripts that depend on the  exact  error
          messages  of  SCCS  commands should set the environment
          variable SCCS_NO_HELP and set LC_ALL=C.


EXIT STATUS

     The following exit values are returned:

     0    Successful completion.

     1    An error occurred.


FILES

     ``g-file''  version retrieved by get

     l.file      file containing extracted delta table info

     p.file      permissions (lock)  file  for  checked-out  ver-
                 sions.   The  p.file  has an arbitrary number of
                 lines, each is related to a get  -e  call.  Each
                 line has the following structure:

SunOS 5.11           Last change: 2015/04/29                   13


User Commands                                         sccs-get(1)

                    old-sid new-sid username date time \
                    [ -ii-arg ][ -xx-arg ][ -zz-arg ]

                 The old-sid is the SID that was checked out with
                 get -e, the new-sid is the SID that will be used
                 for the new version when delta  is  called.  The
                 username  is  the user-name corresponding to the
                 real user ID at the time get -e was called.  The
                 date  and  time fields are in the same format as
                 used  in  the  delta  table  of  the  s.file  as
                 described  in sccsfile(4) for SCCS v4.  In order
                 to grant POSIX compatibility, a two  digit  year
                 is used between 1969 and 2068. For years outside
                 that range, a four digit year is used.  The fol-
                 lowing  fields are only present when one or more
                 of the -i -x or -z options have  been  specified
                 on  the  command line, they refer to the list of
                 included and excluded deltas or to the CMR  list
                 from the NSE enhancements.

     q.file      temporary copy of the  p.file;  renamed  to  the
                 p.file after completion

     s.file      SCCS history file, see sccsfile(4).

     z.file      temporary lock file contains the binary  process
                 id in host byte order followed by the host name

     dump.core   If the file  dump.core  exists  in  the  current
                 directory  and  a  fatal  signal  is received, a
                 coredump is initiated via abort(3).


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

  /usr/ccs/bin/get
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsprot                   |
    |_____________________________|_____________________________|

SunOS 5.11           Last change: 2015/04/29                   14


User Commands                                         sccs-get(1)

  /usr/xpg4/bin/get
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu4t                   |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO

     sccs(1),    sccs-admin(1),    sccs-cdc(1),     sccs-comb(1),
     sccs-cvt(1),   sccs-delta(1),   sccs-help(1),   sccs-log(1),
     sccs-prs(1),   sccs-prt(1),   sccs-rmdel(1),   sccs-sact(1),
     sccs-sccsdiff(1),   sccs-unget(1),   sccs-val(1),  bdiff(1),
     diff(1),     what(1),     sccschangeset(4),     sccsfile(4),
     attributes(5), environ(5), standards(5).


DIAGNOSTICS

     Use the  SCCS  help  command  for  explanations  (see  sccs-
     help(1)).


BUGS

     If the effective user has write  permission  (either  expli-
     citly  or  implicitly)  in the directory containing the SCCS
     files, but the real user does not,  only  one  file  may  be
     named when using -e.


AUTHORS

     The SCCS suite was origininally written by Marc J.  Rochkind
     at  Bell Labs in 1972.  Release 4.0 of SCCS, introducing new
     versions of  the  programs  admin(1),  get(1),  prt(1),  and
     delta(1)  was  published on February 18, 1977; it introduced
     the new text based SCCS v4  history  file  format  (previous
     SCCS  releases used a binary history file format).  The SCCS
     suite was later maintained by various people at AT&T and Sun
     Microsystems.   Since  2006, the SCCS suite is maintained by
     Joerg Schilling.

SunOS 5.11           Last change: 2015/04/29                   15


Man(1) output converted with man2html


FhG Schily's Home VED powered