Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

sccs-get


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

SYNOPSIS
     /usr/ccs/bin/get [-begkmnpst] [-l [p]] [-asequence]
         [-c date-time | -cdate-time] [-Gg-file]
         [-i sid-list | -isid-list] [-r [sid]]
         [-x sid-list | -xsid-list] s.filename...


     /usr/xpg4/bin/get [-begkmnpst] [-l [p]] [-asequence]
         [-c date-time | -cdate-time] [-Gg-file]
         [-i sid-list | -isid-list] [-r sid | -rsid]
         [-x sid-list | -xsid-list] 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:

     -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 super-
                                   sedes 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  indi-
                                   cated 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 charac-
                                   ters may separate the  various
                                   2  digit components. If white-
                                   space  characters  occur,  the
                                   date-time  specification  must
                                   be quoted.


     -e                            Retrieves a version for  edit-
                                   ing.  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. However,  get
                                   will  not  check out a version
                                   of the file if a writable ver-
                                   sion  is present in the direc-
                                   tory.  All SCCS  file  protec-
                                   tions  stored  in  the s.file,
                                   including the release ceiling,
                                   floor,   and  authorized  user
                                   list, are honored by `get -e'.


     -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 version.


     -i sid-list | -isid-list      Specifies a list of deltas  to
                                   include  in the retrieved ver-
                                   sion. 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 output.


     -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.


     -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.


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


     -s                            Suppresses all output normally
                                   written  on  the standard out-
                                   put. However, fatal error mes-
                                   sages  (which always go to the
                                   standard error)  remain  unaf-
                                   fected.


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


  /usr/ccs/bin/get
     -r[sid]    Retrieves the version corresponding to the  indi-
                cated 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 del-
                tas,   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 altogether, or
                when you omit both release and  level,  get  nor-
                mally  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 ver-
                sion 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.


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


     -x sid-list | -xsid-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.


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.









     ____________________________________________________________
      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
     ____________________________________________________________
      %E%        Date newest applied delta was created: yy/mm/dd
     ____________________________________________________________
      %F%        SCCS s.file name
     ____________________________________________________________
      %G%        Date newest applied delta was created: mm/dd/yy
     ____________________________________________________________
      %H%        Current date: mm/dd/yy
     ____________________________________________________________
      %I%        SID of the retrieved version: %R%.%L%.%B%.%S%
     ____________________________________________________________
      %%         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
     ____________________________________________________________
      %U%        Time the  newest  applied  delta  was  created:
                 hh:mm:ss
     ____________________________________________________________
      %W%        Shorthand notation for an ID line with data for
                 what: %Z%%&;%  %I%
     ____________________________________________________________
      %Y%        Module type: value of the t flag in the s.file
     ____________________________________________________________
      %Z%        4-character string: `@(#)', recognized by what
     ____________________________________________________________



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



     ____________________________________________________________________________________________________________________
    | Determination   of|                    |                             |               |                            |
    | SCCS   Identifica-|                    |                             |               |                            |
    | tion String       |                    |                             |               |                            |
    |___________________|____________________|_____________________________|_______________|____________________________|
    | SID (1)  Specified|  -b Option Used (2)|       Other Conditions      |  SID Retrieved|  SID of Delta 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 does not exist|    hR.mL (5)  |        hR.mL.(mB+1).1      |
    |         R         |          -         |  Trunk succ. (6) in  release|      R.mL     |        R.mL.(mB+1).1       |
    |                   |                    |  > 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 release > R |       R.L     |         R.L.(mB+1).1       |
    |       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,
            respectively; `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.


     (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: LANG, LC_ALL,
     LC_COLLATE, LC_CTYPE, LC_MESSAGES, and NLSPATH.

FILES
     ``g-file''    version retrieved by get


     l.file        file containing extracted delta table info


     p.file        permissions (lock) file


     z.file        temporary copy of s.file


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

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


  /usr/xpg4/bin/get




     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu4t                   |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO
     sccs(1), sccs-admin(1), sccs-delta(1),  sccs-help(1),  sccs-
     prs(1),  sccs-prt(1),  sccs-sact(1), sccs-unget(1), what(1),
     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.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments