Un outil pour savoir si une commande est posix - retour accueil
git clone git://bebou.netlib.re/isposix
Log | Files | Refs | README |
unget.html (11148B)
1 <!-- Copyright 2001-2024 IEEE and The Open Group, All Rights Reserved -->
2 <!DOCTYPE HTML>
3 <html lang="en">
4 <head>
5 <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.8.0">
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
7 <link type="text/css" rel="stylesheet" href="style.css"><!-- Generated by The Open Group rhtm tool v1.2.4 -->
8 <!-- Copyright (c) 2001-2024 The Open Group, All Rights Reserved -->
9 <title>unget</title>
10 </head>
11 <body bgcolor="white">
12 <div class="NAVHEADER">
13 <table summary="Header navigation table" class="nav" width="100%" border="0" cellpadding="0" cellspacing="0">
14 <tr class="nav">
15 <td class="nav" width="15%" align="left" valign="bottom"><a href="../utilities/unexpand.html" accesskey="P"><<<
16 Previous</a></td>
17 <td class="nav" width="70%" align="center" valign="bottom"><a href="contents.html">Home</a></td>
18 <td class="nav" width="15%" align="right" valign="bottom"><a href="../utilities/uniq.html" accesskey="N">Next >>></a></td>
19 </tr>
20 </table>
21 <hr align="left" width="100%"></div>
22 <script language="JavaScript" src="../jscript/codes.js"></script><basefont size="3">
23 <center><font size="2">The Open Group Base Specifications Issue 8<br>
24 IEEE Std 1003.1-2024<br>
25 Copyright © 2001-2024 The IEEE and The Open Group</font></center>
26 <hr size="2" noshade>
27 <a name="top" id="top"></a> <a name="unget" id="unget"></a> <a name="tag_20_137" id="tag_20_137"></a><!-- unget -->
28 <h4 class="mansect"><a name="tag_20_137_01" id="tag_20_137_01"></a>NAME</h4>
29 <blockquote>unget — undo a previous get of an SCCS file (<b>DEVELOPMENT</b>)</blockquote>
30 <h4 class="mansect"><a name="tag_20_137_02" id="tag_20_137_02"></a>SYNOPSIS</h4>
31 <blockquote class="synopsis">
32 <div class="box"><code><tt><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt=
33 "[Option Start]" border="0"> unget</tt> <b>[</b><tt>-ns</tt><b>] [</b><tt>-r</tt> <i>SID</i><b>]</b> <i>file</i><tt>... <img src=
34 "../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div>
35 </blockquote>
36 <h4 class="mansect"><a name="tag_20_137_03" id="tag_20_137_03"></a>DESCRIPTION</h4>
37 <blockquote>
38 <p>The <i>unget</i> utility shall reverse the effect of a <a href="../utilities/get.html"><i>get</i></a> <b>-e</b> done prior to
39 creating the intended new delta.</p>
40 </blockquote>
41 <h4 class="mansect"><a name="tag_20_137_04" id="tag_20_137_04"></a>OPTIONS</h4>
42 <blockquote>
43 <p>The <i>unget</i> utility shall conform to XBD <a href="../basedefs/V1_chap12.html#tag_12_02"><i>12.2 Utility Syntax
44 Guidelines</i></a> .</p>
45 <p>The following options shall be supported:</p>
46 <dl compact>
47 <dd></dd>
48 <dt><b>-r </b><i>SID</i></dt>
49 <dd>Uniquely identify which delta is no longer intended. (This would have been specified by <a href=
50 "../utilities/get.html"><i>get</i></a> as the new delta.) The use of this option is necessary only if two or more outstanding
51 <a href="../utilities/get.html"><i>get</i></a> commands for editing on the same SCCS file were done by the same person (login
52 name).</dd>
53 <dt><b>-s</b></dt>
54 <dd>Suppress the writing to standard output of the intended delta's SID.</dd>
55 <dt><b>-n</b></dt>
56 <dd>Retain the file that was obtained by <a href="../utilities/get.html"><i>get</i></a>, which would normally be removed from the
57 current directory.</dd>
58 </dl>
59 </blockquote>
60 <h4 class="mansect"><a name="tag_20_137_05" id="tag_20_137_05"></a>OPERANDS</h4>
61 <blockquote>
62 <p>The following operands shall be supported:</p>
63 <dl compact>
64 <dd></dd>
65 <dt><i>file</i></dt>
66 <dd>A pathname of an existing SCCS file or a directory. If <i>file</i> is a directory, the <i>unget</i> utility shall behave as
67 though each file in the directory were specified as a named file, except that non-SCCS files (last component of the pathname does
68 not begin with <b>s.</b>) and unreadable files shall be silently ignored.
69 <p>If exactly one <i>file</i> operand appears, and it is <tt>'-'</tt>, the standard input shall be read; each line of the standard
70 input shall be taken to be the name of an SCCS file to be processed. Non-SCCS files and unreadable files shall be silently
71 ignored.</p>
72 </dd>
73 </dl>
74 </blockquote>
75 <h4 class="mansect"><a name="tag_20_137_06" id="tag_20_137_06"></a>STDIN</h4>
76 <blockquote>
77 <p>The standard input shall be a text file used only when the <i>file</i> operand is specified as <tt>'-'</tt>. Each line of the
78 text file shall be interpreted as an SCCS pathname.</p>
79 </blockquote>
80 <h4 class="mansect"><a name="tag_20_137_07" id="tag_20_137_07"></a>INPUT FILES</h4>
81 <blockquote>
82 <p>Any SCCS files processed shall be files of an unspecified format.</p>
83 </blockquote>
84 <h4 class="mansect"><a name="tag_20_137_08" id="tag_20_137_08"></a>ENVIRONMENT VARIABLES</h4>
85 <blockquote>
86 <p>The following environment variables shall affect the execution of <i>unget</i>:</p>
87 <dl compact>
88 <dd></dd>
89 <dt><i>LANG</i></dt>
90 <dd>Provide a default value for the internationalization variables that are unset or null. (See XBD <a href=
91 "../basedefs/V1_chap08.html#tag_08_02"><i>8.2 Internationalization Variables</i></a> for the precedence of internationalization
92 variables used to determine the values of locale categories.)</dd>
93 <dt><i>LC_ALL</i></dt>
94 <dd>If set to a non-empty string value, override the values of all the other internationalization variables.</dd>
95 <dt><i>LC_CTYPE</i></dt>
96 <dd>Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as
97 opposed to multi-byte characters in arguments and input files).</dd>
98 <dt><i>LC_MESSAGES</i></dt>
99 <dd><br>
100 Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.</dd>
101 <dt><i>NLSPATH</i></dt>
102 <dd>Determine the location of messages objects and message catalogs.</dd>
103 </dl>
104 </blockquote>
105 <h4 class="mansect"><a name="tag_20_137_09" id="tag_20_137_09"></a>ASYNCHRONOUS EVENTS</h4>
106 <blockquote>
107 <p>Default.</p>
108 </blockquote>
109 <h4 class="mansect"><a name="tag_20_137_10" id="tag_20_137_10"></a>STDOUT</h4>
110 <blockquote>
111 <p>The standard output shall consist of a line for each file, in the following format:</p>
112 <pre>
113 <tt>"%s\n", <</tt><i>SID removed from file</i><tt>>
114 </tt></pre>
115 <p>If there is more than one named file or if a directory or standard input is named, each pathname shall be written before each of
116 the preceding lines:</p>
117 <pre>
118 <tt>"\n%s:\n", <</tt><i>pathname</i><tt>>
119 </tt></pre></blockquote>
120 <h4 class="mansect"><a name="tag_20_137_11" id="tag_20_137_11"></a>STDERR</h4>
121 <blockquote>
122 <p>The standard error shall be used only for diagnostic messages.</p>
123 </blockquote>
124 <h4 class="mansect"><a name="tag_20_137_12" id="tag_20_137_12"></a>OUTPUT FILES</h4>
125 <blockquote>
126 <p>Any SCCS files updated shall be files of an unspecified format. During processing of a <i>file</i>, a locking <i>z-file</i>, as
127 described in <a href="../utilities/get.html"><i>get</i></a>, and a <i>q-file</i> (a working copy of the <i>p-file</i>), may be
128 created and deleted. The <i>p-file</i> and <i>g-file</i>, as described in <a href="../utilities/get.html"><i>get</i></a>, shall be
129 deleted.</p>
130 </blockquote>
131 <h4 class="mansect"><a name="tag_20_137_13" id="tag_20_137_13"></a>EXTENDED DESCRIPTION</h4>
132 <blockquote>
133 <p>None.</p>
134 </blockquote>
135 <h4 class="mansect"><a name="tag_20_137_14" id="tag_20_137_14"></a>EXIT STATUS</h4>
136 <blockquote>
137 <p>The following exit values shall be returned:</p>
138 <dl compact>
139 <dd></dd>
140 <dt> 0</dt>
141 <dd>Successful completion.</dd>
142 <dt>>0</dt>
143 <dd>An error occurred.</dd>
144 </dl>
145 </blockquote>
146 <h4 class="mansect"><a name="tag_20_137_15" id="tag_20_137_15"></a>CONSEQUENCES OF ERRORS</h4>
147 <blockquote>
148 <p>Default.</p>
149 </blockquote>
150 <hr>
151 <div class="box"><em>The following sections are informative.</em></div>
152 <h4 class="mansect"><a name="tag_20_137_16" id="tag_20_137_16"></a>APPLICATION USAGE</h4>
153 <blockquote>
154 <p>None.</p>
155 </blockquote>
156 <h4 class="mansect"><a name="tag_20_137_17" id="tag_20_137_17"></a>EXAMPLES</h4>
157 <blockquote>
158 <p>None.</p>
159 </blockquote>
160 <h4 class="mansect"><a name="tag_20_137_18" id="tag_20_137_18"></a>RATIONALE</h4>
161 <blockquote>
162 <p>None.</p>
163 </blockquote>
164 <h4 class="mansect"><a name="tag_20_137_19" id="tag_20_137_19"></a>FUTURE DIRECTIONS</h4>
165 <blockquote>
166 <p>If this utility is directed to create a new directory entry that contains any bytes that have the encoded value of a
167 <newline> character, implementations are encouraged to treat this as an error. A future version of this standard may require
168 implementations to treat this as an error.</p>
169 </blockquote>
170 <h4 class="mansect"><a name="tag_20_137_20" id="tag_20_137_20"></a>SEE ALSO</h4>
171 <blockquote>
172 <p><a href="../utilities/delta.html#"><i>delta</i></a> , <a href="../utilities/get.html#"><i>get</i></a> , <a href=
173 "../utilities/sact.html#"><i>sact</i></a></p>
174 <p>XBD <a href="../basedefs/V1_chap08.html#tag_08"><i>8. Environment Variables</i></a> , <a href=
175 "../basedefs/V1_chap12.html#tag_12_02"><i>12.2 Utility Syntax Guidelines</i></a></p>
176 </blockquote>
177 <h4 class="mansect"><a name="tag_20_137_21" id="tag_20_137_21"></a>CHANGE HISTORY</h4>
178 <blockquote>
179 <p>First released in Issue 2.</p>
180 </blockquote>
181 <h4 class="mansect"><a name="tag_20_137_22" id="tag_20_137_22"></a>Issue 6</h4>
182 <blockquote>
183 <p>The normative text is reworded to avoid use of the term "must" for application requirements.</p>
184 </blockquote>
185 <h4 class="mansect"><a name="tag_20_137_23" id="tag_20_137_23"></a>Issue 7</h4>
186 <blockquote>
187 <p>SD5-XCU-ERN-97 is applied, updating the SYNOPSIS.</p>
188 </blockquote>
189 <h4 class="mansect"><a name="tag_20_137_24" id="tag_20_137_24"></a>Issue 8</h4>
190 <blockquote>
191 <p>Austin Group Defect 251 is applied, encouraging implementations to disallow the creation of filenames containing any bytes that
192 have the encoded value of a <newline> character.</p>
193 <p>Austin Group Defect 1122 is applied, changing the description of <i>NLSPATH .</i></p>
194 </blockquote>
195 <div class="box"><em>End of informative text.</em></div>
196 <hr>
197 <p> </p>
198 <a href="#top"><span class="topOfPage">return to top of page</span></a><br>
199 <hr size="2" noshade>
200 <center><font size="2">UNIX® is a registered Trademark of The Open Group.<br>
201 POSIX™ is a Trademark of The IEEE.<br>
202 Copyright © 2001-2024 The IEEE and The Open Group, All Rights Reserved<br>
203 [ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
204 "../functions/contents.html">XSH</a> | <a href="../utilities/contents.html">XCU</a> | <a href="../xrat/contents.html">XRAT</a>
205 ]</font></center>
206 <hr size="2" noshade>
207 <div class="NAVHEADER">
208 <table summary="Header navigation table" class="nav" width="100%" border="0" cellpadding="0" cellspacing="0">
209 <tr class="nav">
210 <td class="nav" width="15%" align="left" valign="bottom"><a href="../utilities/unexpand.html" accesskey="P"><<<
211 Previous</a></td>
212 <td class="nav" width="70%" align="center" valign="bottom"><a href="contents.html">Home</a></td>
213 <td class="nav" width="15%" align="right" valign="bottom"><a href="../utilities/uniq.html" accesskey="N">Next >>></a></td>
214 </tr>
215 </table>
216 <hr align="left" width="100%"></div>
217 </body>
218 </html>