huschi.net

unshar(1)                        User Commands                       unshar(1)

NAME
       unshar - unpack a shar archive
SYNOPSIS
       unshar [-flag [value]]... [--opt-name[[=| ]value]]... [ file ... ]
DESCRIPTION
       Unshar scans the input files (typically email messages) looking for the
       start of a shell archive.  If no files are given, then  standard  input
       is  processed  instead.  It then passes each archive discovered through
       an invocation of the shell program to unpack it.
OPTIONS
       -d dir, --directory=dir
              change directory to dir first.
              Before unpacking any files, change the current directory to dir.
       -c, --overwrite
              Overwrite any pre-existing files.
              This option is passed through as an option  to  the  shar  file.
              Many shell archive scripts accept a -c argument to indicate that
              existing files should be overwritten.
       -f, --force
              This is an alias for the --overwrite option.
       -E split-pat, --split-at=split-pat
              separate archives on split-pat lines.
              With this option, unshar isolates each different  shell  archive
              from the others which have been placed in the same file, unpack-
              ing each in turn, from the beginning of the  file  to  the  end.
              Its proper operation relies on the fact that many shar files are
              terminated by a readily identifiable string.
              For example, noticing that  most  `.signatures'  have  a  double
              hyphen  ("--")  on  a line right before them, one can then some-
              times use --split-at=--.  The signature will  then  be  skipped,
              along with the headers of the following message.
       -e, --exit-0
              split  archives  at "exit 0" lines.  This option must not appear
              in combination with any of the following options: split-at.
              Most shell archives end with a line consisting of  simply  "exit
              0".   This option is equivalent to (and conflicts with) --split-
              at="exit 0".
       -h, --help
              Display usage information and exit.
       -!, --more-help
              Pass the extended usage information through a pager.
       -R [rcfile], --save-opts[=rcfile]
              Save the option state to rcfile.  The default is the  last  con-
              figuration file listed in the OPTION PRESETS section, below.
       -r rcfile, --load-opts=rcfile, --no-load-opts
              Load  options  from  rcfile.  The no-load-opts form will disable
              the loading of earlier RC/INI files.  --no-load-opts is  handled
              early, out of order.
       -v [{v|c|n}], --version[={v|c|n}]
              Output  version of program and exit.  The default mode is `v', a
              simple version.  The `c' mode will print  copyright  information
              and `n' will print the full copyright notice.
OPTION PRESETS
       Any option that is not marked as not presettable may be preset by load-
       ing values from configuration  ("RC"  or  ".INI")  file(s).   The  file
       "$HOME/.sharrc" will be used, if present.
FILES
       See OPTION PRESETS for configuration files.
EXIT STATUS
       One of the following exit values will be returned:
       0 (EXIT_SUCCESS)
              Successful program execution.
       1 (EXIT_FAILURE)
              The operation failed or the command syntax was not valid.
       66 (EX_NOINPUT)
              A specified configuration file could not be loaded.
       70 (EX_SOFTWARE)
              libopts  had an internal operational error.  Please report it to
              autogen-users AT lists.net.  Thank you.
SEE ALSO
       shar(1)
AUTHORS
       The shar and unshar programs is the collective work  of  many  authors.
       Many  people  contributed  by  reporting  problems,  suggesting various
       improvements or submitting actual code.  A list of these people  is  in
       the THANKS file in the sharutils distribution.
COPYRIGHT
       Copyright  (C)  1994-2013  Free  Software  Foundation,  Inc. all rights
       reserved.  This program is released under the terms of the GNU  General
       Public License, version 3 or later.
BUGS
       Please  put  sharutils in the subject line for emailed bug reports.  It
       helps to spot the message.
       Please send bug reports to: bug-gnu-utils AT gnu.org
NOTES
       This manual page was AutoGen-erated from the unshar option definitions.

GNU sharutils (4.13.3)            06 Jan 2013                        unshar(1)