# unget

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           unget — undo a previous get of an SCCS file (**DEVELOPMENT**)
    


## SYNOPSIS



           unget **[** -ns**] [** -r _SID_**]**_file_...
    


## DESCRIPTION



           The _unget_ utility shall reverse the effect of a _get_ **-e** done prior
           to creating the intended new delta.
    


## OPTIONS



           The _unget_ utility shall conform to the Base Definitions volume of
           POSIX.1‐2017, _Section 12.2_ , _Utility Syntax Guidelines_.
    
           The following options shall be supported:
    
           **-r** _SID_    Uniquely identify which delta is no longer intended.
                     (This would have been specified by _get_ as the new
                     delta.) The use of this option is necessary only if two
                     or more outstanding _get_ commands for editing on the same
                     SCCS file were done by the same person (login name).
    
           **-s** Suppress the writing to standard output of the intended
                     delta's SID.
    
           **-n** Retain the file that was obtained by _get_ , which would
                     normally be removed from the current directory.
    


## OPERANDS



           The following operands shall be supported:
    
           _file_      A pathname of an existing SCCS file or a directory. If
                     _file_ is a directory, the _unget_ utility shall behave as
                     though each file in the directory were specified as a
                     named file, except that non-SCCS files (last component
                     of the pathname does not begin with **s.**)  and unreadable
                     files shall be silently ignored.
    
                     If exactly one _file_ operand appears, and it is **'-'** , the
                     standard input shall be read; each line of the standard
                     input shall be taken to be the name of an SCCS file to
                     be processed. Non-SCCS files and unreadable files shall
                     be silently ignored.
    


## STDIN



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


## INPUT FILES



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


## ENVIRONMENT VARIABLES



           The following environment variables shall affect the execution of
           _unget_ :
    
           _LANG_      Provide a default value for the internationalization
                     variables that are unset or null. (See the Base
                     Definitions volume of POSIX.1‐2017, _Section 8.2_ ,
                     _Internationalization Variables_ for the precedence of
                     internationalization variables used to determine the
                     values of locale categories.)
    
           _LC_ALL_    If set to a non-empty string value, override the values
                     of all the other internationalization variables.
    
           _LC_CTYPE_  Determine the locale for the interpretation of sequences
                     of bytes of text data as characters (for example,
                     single-byte as opposed to multi-byte characters in
                     arguments and input files).
    
           _LC_MESSAGES_
                     Determine the locale that should be used to affect the
                     format and contents of diagnostic messages written to
                     standard error.
    
           _NLSPATH_   Determine the location of message catalogs for the
                     processing of _LC_MESSAGES_.
    


## ASYNCHRONOUS EVENTS



           Default.
    


## STDOUT



           The standard output shall consist of a line for each file, in the
           following format:
    
               "%s\n", <_SID removed from file_ >
    
           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 the
           preceding lines:
    
               "\n%s:\n", <_pathname_ >
    


## STDERR



           The standard error shall be used only for diagnostic messages.
    


## OUTPUT FILES



           Any SCCS files updated shall be files of an unspecified format.
           During processing of a _file_ , a locking _z-file_ , as described in
           _get_ , and a _q-file_ (a working copy of the _p-file_), may be created
           and deleted. The _p-file_ and _g-file_ , as described in _get_ , shall be
           deleted.
    


## EXTENDED DESCRIPTION



           None.
    


## EXIT STATUS



           The following exit values shall be returned:
    
            0    Successful completion.
    
           >0    An error occurred.
    


## CONSEQUENCES OF ERRORS



           Default.
    
           _The following sections are informative._
    


## APPLICATION USAGE



           None.
    


## EXAMPLES



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *