📄 get.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>get</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_001_014_833"> </a>NAME</h4><blockquote>get - get a version of an SCCS file (<b>DEVELOPMENT</b>)</blockquote><h4><a name = "tag_001_014_834"> </a>SYNOPSIS</h4><blockquote><pre><code>get <b>[</b>-begkmlLpst<b>][</b>-c <i>cutoff</i><b>][</b>-i <i>list</i><b>][</b>-r <i>SID</i><b>][</b>-x <i>list</i><b>] </b><i>file</i>... get <b>[</b>-begkmpst<b>][</b>-c <i>cutoff</i><b>][</b>-i <i>list</i><b>][ </b>-l<b>[</b>p<b>]][</b>-r <i>SID</i><b>][</b>-x <i>list</i><b>]</b><i> file</i>... </code></pre></blockquote><h4><a name = "tag_001_014_835"> </a>DESCRIPTION</h4><blockquote>The<i>get</i>utilitygenerates atext file fromeach named SCCS<i>file</i>according to the specifications givenby its options.<p>The generated text is normally written into a file called the<i>g-file</i>whose name is derived from the SCCS filename by simplyremoving the leading<b>s.</b>.<p></blockquote><h4><a name = "tag_001_014_836"> </a>OPTIONS</h4><blockquote>The<i>get</i>utility supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b> </a> ,except that,in the obsolescent form,<b>-l</b>option has an optional option-argument thatcannot be presented as a separate argument(<b>-lp</b>).When the<b>-l</b>and<b>-p</b>options are both needed,the application must avoid ambiguityby giving them as separate arguments(<b>-l -p</b>),reversing their sequence(<b>-pl</b>)or separating them with other optionsin a single argument (such as<b>-ltp</b>).The following options are supported:<dl compact><dt><b>-r </b><i>SID</i><dd>Indicate the SCCS Identification String (SID) of the version (delta)of an SCCS file to be retrieved.The table shows, for the most useful cases, what versionof an SCCS file is retrieved (as well as the SIDof the version to be eventually created by<i><a href="delta.html">delta</a></i>if the<b>-e</b>option is also used),as a function of the SID specified.<dt><b>-c </b><i>cutoff</i><dd>Indicate the<i>cutoff</i>date-time, in the form:<pre><code><i>YY</i><b>[</b><i>MM</i><b>[</b><i>DD</i><b>[</b><i>HH</i><b>[</b><i>MM</i><b>[</b><i>SS</i><b>]]]]]</b></code></pre>For the <i>YY</i> component,values in the range [69-99] refer to years in the twentieth century(1969 to 1999 inclusive); values in the range [00-68] refer toyears in the twenty-first century (2000 to 2068 inclusive).No changes (deltas) to the SCCS file that were created afterthe specified<i>cutoff</i>date-time are included in the generatedtext file.Units omitted from the date-time defaultto their maximum possible values;for example,<b>-c 7502</b>is equivalent to<b>-c 750228235959</b>.Any number of non-numeric characters may separatethe various 2-digit pieces of the<i>cutoff</i>date-time.This feature allows the user to specify a<i>cutoff</i>date in the form:<b>-c "77/2/2 9:22:25"</b>.<dt><b>-e</b><dd>Indicate that the<i>get</i>is for the purpose of editing or making a change(delta) to the SCCS file via a subsequent use of<i><a href="delta.html">delta</a></i>.The<b>-e</b>option used in a<i>get</i>for a particular version (SID) of the SCCS file preventsfurther<i>get</i>commandsfrom editing on the same SID until<i><a href="delta.html">delta</a></i>is executed or thej(joint edit) flag is set in the SCCS file.Concurrent use of<i>get</i><b>-e</b>for different SIDs is always allowed.If the<i>g-file</i>generated by<i>get</i>with a<b>-e</b>option is accidentally ruined in the process of editing,it may be regenerated by reexecuting the<i>get</i>command with the<b>-k</b>option in place of the<b>-e</b>option.SCCSfile protection specified via theceiling, floor and authorised user liststored in the SCCS file is enforced when the<b>-e</b>option is used.<dt><b>-b</b><dd>Use with the<b>-e</b>option to indicate that the new delta should have an SID in a new branchas shown in the table below.This option is ignored if thebflag is not present in the fileor if the retrieved delta is not a leaf delta.(A leaf delta is one that has no successors onthe SCCS file tree.)<dl><dt><b>Note:</b><dd>A branch delta may always be created from a non-leaf delta.</dl><br><br><dt><b>-i </b><i>list</i><dd>Indicate a<i>list</i>of deltas to be included (forced to be applied)in the creation of the generated file.The<i>list</i>has the following syntax:<pre><code><list> ::= <range> | <list> , <range><range> ::= SID | SID - SID</code></pre><p>SID, the SCCS Identification of a delta, maybe in any form shown in the "SID Specified" column ofthe table below.Partial SIDs are interpreted as shown in the "SID Retrieved"column of the table below.<br><br><dt><b>-x </b><i>list</i><dd>Indicate a<i>list</i>of deltas to be excluded (forced not to be applied)in the creation of the generated file.See the<b>-i</b>option for the<i>list</i>format.<br><dt><b>-k</b><dd>Suppress replacement of identification keywords(see below) in the retrieved text by their value.The<b>-k</b>option is implied by the<b>-e</b>option.<br><dt><b>-l</b><dd>Write a delta summary into an<i>l-file</i>.<br><dt><b>-L</b><dd>Write a delta summary to standard output.All informative output that normally is written to standard outputwill be written to standard error instead, unless the<b>-s</b>option is used, in which case it is suppressed.<br><dt><b>-lp</b><dd>Equivalent to<b>-L</b>.<br><dt><b>-p</b><dd>Write the text retrieved from the SCCS file to the standard output.No<i>g-file</i>is created.All informative output that normally goes to the standard outputgoes to standard error instead,unless the<b>-s</b>option is used, in which case it disappears.<br><dt><b>-s</b><dd>Suppress all informative output normally written to standard output.However, fatal error messages(which are always written to the standard error)remain unaffected.<br><dt><b>-m</b><dd>Precede each text line retrieved from the SCCS fileby the SIDof the delta that inserted the text line in the SCCS file.The format is:<p><code><tt>"%s\ts"</tt>, <<i>SID</i>>,<<i>text line</i>></code><br><br><dt><b>-n</b><dd>Precede each generated text line with the<b>%M%</b>identification keyword value (see below).The format is:<p><code><tt>"%s\ts"</tt>, <<i>%M% value</i>>,<<i>text line</i>></code><p>When both the<b>-m</b>and<b>-n</b>options are used, the<<i>text line</i>>is replaced by the<b>-m</b>option-generated format.<br><br><dt><b>-g</b><dd>Suppress the actual retrieval of text from the SCCS file.It is primarily used to generate an<i>l-file</i>,or to verify the existence of a particular SID.<br><dt><b>-t</b><dd>Use to access the most recently created(top) delta in a given release (for example,r<b>-1</b>),or release and level (for example,r<b>-1.2</b>).<p></dl></blockquote><h4><a name = "tag_001_014_837"> </a>OPERANDS</h4><blockquote>The following operands are supported:<dl compact><dt><i>file</i><dd>A pathname of an existing SCCS file or a directory.If<i>file</i>is a directory,<i>get</i>behaves as though each file in the directory werespecified as a named file,except that non-SCCS files(last component of the pathname does not begin withs.)and unreadable files are silently ignored.If a single instance<i>file</i>is specified as -,the standard input is read;each line of the standard input is taken to be the name of an SCCS fileto be processed.Non-SCCS files and unreadable files are silently ignored.</dl></blockquote><h4><a name = "tag_001_014_838"> </a>STDIN</h4><blockquote>The standard input is a text file used only if the<i>file</i>operand is specified as -.Each line of the text file is interpreted as an SCCS pathname.</blockquote><h4><a name = "tag_001_014_839"> </a>INPUT FILES</h4><blockquote>The SCCS files are files of an unspecified format.</blockquote><h4><a name = "tag_001_014_840"> </a>ENVIRONMENT VARIABLES</h4><blockquote>The following environment variables affect the execution of<i>get</i>:<dl compact><dt><i>LANG</i><dd>Provide a default value for the internationalisation variablesthat are unset or null.If<i>LANG</i>is unset or null, the corresponding value from theimplementation-dependent default locale will be used.If any of the internationalisation variables contains an invalid setting, theutility will behave as if none of the variables had been defined.<dt><i>LC_ALL</i><dd>If set to a non-empty string value,override the values of all the other internationalisation variables.<dt><i>LC_CTYPE</i><dd>Determine thelocale for the interpretation of sequences of bytes of text data ascharacters (for example, single- as opposed to multi-byte charactersin arguments and input files).<dt><i>LC_MESSAGES</i><dd>Determine the locale that should be used to affectthe format and contents of diagnosticmessages written to standard error,and informative messages written to standard output(or standard error, if the<b>-p</b>option is used).<dt><i>NLSPATH</i><dd>Determine the location of message cataloguesfor the processing of<i>LC_MESSAGES .</i></dl></blockquote><h4><a name = "tag_001_014_841"> </a>ASYNCHRONOUS EVENTS</h4><blockquote>Default.</blockquote><h4><a name = "tag_001_014_842"> </a>STDOUT</h4><blockquote>For each file processed,<i>get</i>writes to standard output the SID being accessed andthe number of lines retrieved from the SCCS file,in the following format:<p><code><tt>"%s\n%d lines\n"</tt>, <<i>SID</i>>,<<i>number of lines</i>></code><p>If the<b>-e</b>option is used, the SID of the delta to be made appearsafter the SIDaccessed and before the number of lines generated,in the POSIX locale:<p><code><pre><tt>"%s\nnew delta %s\n%d\n"</tt>, <<i>SID accessed</i>>,<<i>SID to be made</i>>,<<i>number of lines</i>></pre></code><p>If there is more than one named fileor if a directory or standard input is named,each pathname is written before each of the linesshown in one of the preceding formats:<p><code><tt>"\n%s:\n"</tt>, <<i>pathname</i>></code><p>If the<b>-L</b>(or<b>-lp</b>)option is used, a delta summary will be written followingthe format specified below for<i>l-files</i>.<p>If the<b>-i</b>option is used, included deltas are listed following the notation,in the POSIX locale:<pre><code>"Included:\n"</code></pre><p>If the<b>-x</b>option is used, excluded deltas are listed following the notation,in the POSIX locale:<pre><code>"Excluded:\n"</code></pre><p>If the<b>-p</b>,<b>-L</b>or<b>-lp</b>options are specified, the standard output consists of thetext retrieved from the SCCS file.</blockquote><h4><a name = "tag_001_014_843"> </a>STDERR</h4><blockquote>The standard error is used only for diagnostic messages,except if the<b>-p</b>,<b>-L</b>or<b>-lp</b>options are specified, it includes all informative messages normallysent to standard output.</blockquote><h4><a name = "tag_001_014_844"> </a>OUTPUT FILES</h4><blockquote>Several auxiliary files may be created by<i>get</i>.⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -