unget(1p)

1UNGET(P)                   POSIX Programmer's Manual                  UNGET(P)
2
3
4

NAME

6       unget - undo a previous get of an SCCS file (DEVELOPMENT)
7

SYNOPSIS

9       unget [-ns][-r SID] file...
10

DESCRIPTION

12       The  unget  utility  shall reverse the effect of a get -e done prior to
13       creating the intended new delta.
14

OPTIONS

16       The unget utility shall conform  to  the  Base  Definitions  volume  of
17       IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.
18
19       The following options shall be supported:
20
21       -r  SID
22              Uniquely identify which delta is no longer intended. (This would
23              have been specified by get as the new delta.) The  use  of  this
24              option is necessary only if two or more outstanding get commands
25              for editing on the same SCCS file were done by the  same  person
26              (login name).
27
28       -s     Suppress  the writing to standard output of the intended delta's
29              SID.
30
31       -n     Retain the file that was obtained by get, which  would  normally
32              be removed from the current directory.
33
34

OPERANDS

36       The following operands shall be supported:
37
38       file   A pathname of an existing SCCS file or a directory. If file is a
39              directory, the unget utility shall behave as though each file in
40              the  directory  were specified as a named file, except that non-
41              SCCS files (last component of the pathname does not  begin  with
42              s.) and unreadable files shall be silently ignored.
43
44       If exactly one file operand appears, and it is '-' , the standard input
45       shall be read; each line of the standard input shall be taken to be the
46       name  of  an  SCCS file to be processed.  Non-SCCS files and unreadable
47       files shall be silently ignored.
48
49

STDIN

51       The standard input shall be a text file used only when the file operand
52       is  specified  as '-' . Each line of the text file shall be interpreted
53       as an SCCS pathname.
54

INPUT FILES

56       Any SCCS files processed shall be files of an unspecified format.
57

ENVIRONMENT VARIABLES

59       The following environment  variables  shall  affect  the  execution  of
60       unget:
61
62       LANG   Provide  a  default value for the internationalization variables
63              that are unset or null. (See  the  Base  Definitions  volume  of
64              IEEE Std 1003.1-2001,  Section  8.2,  Internationalization Vari‐
65              ables for the precedence of internationalization variables  used
66              to determine the values of locale categories.)
67
68       LC_ALL If  set  to a non-empty string value, override the values of all
69              the other internationalization variables.
70
71       LC_CTYPE
72              Determine the locale for  the  interpretation  of  sequences  of
73              bytes  of  text  data as characters (for example, single-byte as
74              opposed to multi-byte characters in arguments and input files).
75
76       LC_MESSAGES
77              Determine the locale that should be used to  affect  the  format
78              and contents of diagnostic messages written to standard error.
79
80       NLSPATH
81              Determine the location of message catalogs for the processing of
82              LC_MESSAGES .
83
84

ASYNCHRONOUS EVENTS

86       Default.
87

STDOUT

89       The standard output shall consist of a line for each file, in the  fol‐
90       lowing format:
91
92
93              "%s\n", <SID removed from file>
94
95       If  there  is  more  than  one named file or if a directory or standard
96       input is named, each pathname shall be written before each of the  pre‐
97       ceding lines:
98
99
100              "\n%s:\n", <pathname>
101

STDERR

103       The standard error shall be used only for diagnostic messages.
104

OUTPUT FILES

106       Any  SCCS files updated shall be files of an unspecified format. During
107       processing of a file, a locking z-file, as described in get, and  a  q-
108       file (a working copy of the p-file), may be created and deleted. The p-
109       file and g-file, as described in get, shall be deleted.
110

EXTENDED DESCRIPTION

112       None.
113

EXIT STATUS

115       The following exit values shall be returned:
116
117        0     Successful completion.
118
119       >0     An error occurred.
120
121

CONSEQUENCES OF ERRORS

123       Default.
124
125       The following sections are informative.
126

APPLICATION USAGE

128       None.
129

EXAMPLES

131       None.
132

RATIONALE

134       None.
135

FUTURE DIRECTIONS

137       None.
138

COPYRIGHT

143       Portions of this text are reprinted and reproduced in  electronic  form
144       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
145       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
146       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
147       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
148       event of any discrepancy between this version and the original IEEE and
149       The Open Group Standard, the original IEEE and The Open Group  Standard
150       is  the  referee document. The original Standard can be obtained online
151       at http://www.opengroup.org/unix/online.html .
152
153
154
155IEEE/The Open Group                  2003                             UNGET(P)