\input texinfo   @c -*-texinfo-*-
@setfilename swcopy.info
@comment direntry.in
@dircategory Individual utilities
@direntry
* swcopy: (swbis).               copy POSIX format packages
@end direntry
@comment ===============================================================
@comment WARNING: Do NOT edit this file.  It was produced automatically
@comment by man2info on Fri Nov  2 20:39:29 EDT 2018
@comment for jhl@
@comment from man/man8/swcopy.8
@comment in /home/jhl/swbis-1.13.1/doc
@comment ===============================================================

@comment @documentencoding ISO-8859-1

@comment troff -man typesetting style: headers, footers, no paragraph indentation

@paragraphindent none

@iftex
@parskip = 0.5@normalbaselineskip plus 3pt minus 1pt
@end iftex

@set lq ``
@set rq ''

@comment TROFF INPUT: ...\" $Header: /usr/src/docbook-to-man/cmd/RCS/docbook-to-man.sh,v 1.3 1996/06/17 03:36:49 fld Exp $
@comment ...\" $Header: /usr/src/docbook-to-man/cmd/RCS/docbook-to-man.sh,v 1.3 1996/06/17 03:36:49 fld Exp $
@comment TROFF INPUT: ...\"
@comment ...\"
@comment TROFF INPUT: ...\"	transcript compatibility for postscript use.
@comment ...\"	transcript compatibility for postscript use.
@comment TROFF INPUT: ...\"
@comment ...\"
@comment TROFF INPUT: ...\"	synopsis:  .P! <file.ps>
@comment ...\"	synopsis:  .P! <file.ps>
@comment TROFF INPUT: ...\"
@comment ...\"
@comment TROFF INPUT: .de P!
@comment .de P!
\.
@comment TROFF INPUT: .fl			\" force out current output buffer
@comment .fl			\" force out current output buffer
\\!%PB
\\!/showpage@{@}def
@comment TROFF INPUT: ...\" the following is from Ken Flowers -- it prevents dictionary overflows
@comment ...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
@comment TROFF INPUT: .fl			\" prolog
@comment .fl			\" prolog
@comment TROFF INPUT: .sy cat \\$1\" bring in postscript file
@comment .sy cat \\$1\" bring in postscript file
@comment TROFF INPUT: ...\" the following line matches the tempdict above
@comment ...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
@comment TROFF INPUT: .sp \\$2u	\" move below the image
@comment .sp \\$2u	\" move below the image
@comment TROFF INPUT: ..
@comment ..
@comment TROFF INPUT: .de pF
@comment .de pF
@comment TROFF INPUT: .ie     \\*(f1 .ds f1 \\n(.f
@comment .ie     \\*(f1 .ds f1 \\n(.f
@comment TROFF INPUT: .el .ie \\*(f2 .ds f2 \\n(.f
@comment .el .ie \\*(f2 .ds f2 \\n(.f
@comment TROFF INPUT: .el .ie \\*(f3 .ds f3 \\n(.f
@comment .el .ie \\*(f3 .ds f3 \\n(.f
@comment TROFF INPUT: .el .ie \\*(f4 .ds f4 \\n(.f
@comment .el .ie \\*(f4 .ds f4 \\n(.f
@comment TROFF INPUT: .el .tm ? font overflow
@comment .el .tm ? font overflow
@comment TROFF INPUT: .ft \\$1
@comment .ft \\$1
@comment TROFF INPUT: ..
@comment ..
@comment TROFF INPUT: .de fP
@comment .de fP
@comment TROFF INPUT: .ie     !\\*(f4 \{\
@comment .ie     !\\*(f4 \@{\
@comment TROFF INPUT: .	ft \\*(f4
@comment .	ft \\*(f4
@comment TROFF INPUT: .	ds f4\"
@comment .	ds f4\"
'	br \@}
@comment TROFF INPUT: .el .ie !\\*(f3 \{\
@comment .el .ie !\\*(f3 \@{\
@comment TROFF INPUT: .	ft \\*(f3
@comment .	ft \\*(f3
@comment TROFF INPUT: .	ds f3\"
@comment .	ds f3\"
'	br \@}
@comment TROFF INPUT: .el .ie !\\*(f2 \{\
@comment .el .ie !\\*(f2 \@{\
@comment TROFF INPUT: .	ft \\*(f2
@comment .	ft \\*(f2
@comment TROFF INPUT: .	ds f2\"
@comment .	ds f2\"
'	br \@}
@comment TROFF INPUT: .el .ie !\\*(f1 \{\
@comment .el .ie !\\*(f1 \@{\
@comment TROFF INPUT: .	ft \\*(f1
@comment .	ft \\*(f1
@comment TROFF INPUT: .	ds f1\"
@comment .	ds f1\"
'	br \@}
@comment TROFF INPUT: .el .tm ? font underflow
@comment .el .tm ? font underflow
@comment TROFF INPUT: ..
@comment ..
@comment TROFF INPUT: .ds f1\"

@comment WARNING: man/man8/swcopy.8:49:%%unrecognized define-string command: [.ds f1\"]

@comment TROFF INPUT: .ds f2\"

@comment WARNING: man/man8/swcopy.8:50:%%unrecognized define-string command: [.ds f2\"]

@comment TROFF INPUT: .ds f3\"

@comment WARNING: man/man8/swcopy.8:51:%%unrecognized define-string command: [.ds f3\"]

@comment TROFF INPUT: .ds f4\"

@comment WARNING: man/man8/swcopy.8:52:%%unrecognized define-string command: [.ds f4\"]

@comment TROFF INPUT: .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
@comment .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
@comment TROFF INPUT: .TH "swcopy" "8"

@headings off
@everyheading SWCOPY(8) @| @| SWCOPY(8)
@everyfooting  @| @thispage @|

@node Top

@chapter swcopy" "8


@comment TROFF INPUT: .hy 0
@comment .hy 0
@comment TROFF INPUT: .if n .na
@comment .if n .na
@comment TROFF INPUT: .SH "NAME"
@c DEBUG: print_menu("Top")

@ifnottex
@menu
* NAME::
* SYNOPSIS::
* DESCRIPTION::
* OPTIONS::
* TARGET COPYING RULES::
* IMPLEMENTATION EXTENSIONS::
* EXTENDED OPTIONS::
* RETURN VALUE::
* NOTES::
* REQUISITE UTILITIES::
* FILES::
* APPLICABLE STANDARDS::
* SEE ALSO::
* IDENTIFICATION::
* BUGS::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node NAME

@section NAME

swcopy @r{---} Copy POSIX and RPM packages.
@comment TROFF INPUT: .SH "SYNOPSIS"
@c DEBUG: print_menu("NAME")
@comment MAN2TEXI: EON

@node SYNOPSIS

@section SYNOPSIS

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
@b{swcopy} [-p] [-s @i{source@t{_}file}] [-f @i{file}] [-t @i{targetfile}] \\
[-x @i{option=value}] [-X @i{options@t{_}file}] [-W @i{option}] \\
[software@t{_}selections] [@@target [target1...]]
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------

@comment TROFF INPUT: .SH "DESCRIPTION"
@c DEBUG: print_menu("SYNOPSIS")
@comment MAN2TEXI: EON

@node DESCRIPTION

@section DESCRIPTION

@comment TROFF INPUT: .PP

@b{swcopy} copies a POSIX distribution from a source archive or directory to a target
archive directory.  Neither swcopy nor any component of swbis is required
on the target host, however, the target host must look like a Unix system at
the shell and command-line utility level.  Remote network connections are made
by ssh.  Ssh is the default but rsh can be selected by a command line
option.
@comment TROFF INPUT: .PP

Before and during data transfer to the target, the distribution is audited.
Package auditing includes parsing the INDEX and INFO meta-data files.
The package pathnames are checked for consistency with a valid layout.
@b{swcopy} can be made to operate on arbitrary data or
archives not in POSIX format by using the @minus{}@minus{}no-audit option.
By default and with no external influences (i.e. swdefaults file) swcopy
will read a archive on stdin and write an audited archive on stdout.
The uncompressed audited output file will be identical to the uncompressed
input file unless an error occurs.  Compressed archives that are audited will
be re-compressed in the same format, however, the resulting file may
not be identical to the input file (i.e. date, filename, and other stored data
in the compressed format will be different).
@comment TROFF INPUT: .PP

@b{swcopy} operates on serial archives (e.g. compressed tar archives) or on file system
directories.  It will attempt to preserve the form (archive or directory) and
compression state of the source object.  An exception is "." as a target
(See Implementation Extensions below).
@comment TROFF INPUT: .SH "OPTIONS"
@c DEBUG: print_menu("DESCRIPTION")
@comment MAN2TEXI: EON

@node OPTIONS

@section OPTIONS

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-f FILE}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Reads software@t{_}selections from FILE. (Not implemented).
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-p}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Preview the operation. Information is written to stdout.
The target is not written and no remote connections are established.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------

@comment TROFF INPUT: .PP

@b{-s SOURCE}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Specify the source file SOURCE, "-" is standard input.
The syntax is the same as for a target.
SOURCE may be a directory or archive file.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-t targetfile}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Specify a file containing a list of targets (one per line).
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-x option=value}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Specify the extended option overriding the defaults file value.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-X FILE}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Specify the extended options filename, FILE,  overriding the default filenames.
This option may be given more then once. If the resulting specified value is an empty string
then reading of any options file is disabled.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-v}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Given one time it is identical to -x verbose=2.
This option can be given multiple times with increasing effect.
(Implementation extension option).
@comment TROFF INPUT: .br
@comment .br
-v  is level 2, -vv is level 3,... etc.
@comment TROFF INPUT: .br
@comment .br
    level 0: silent on stdout and stderr.
@comment TROFF INPUT: .br
@comment .br
    level 1: fatal and warning messages to stderr.
@comment TROFF INPUT: .br
@comment .br
-v  level 2: level 1 plus a progress bar.
@comment TROFF INPUT: .br
@comment .br
-vv level 3: level 2 plus script stderr.
@comment TROFF INPUT: .br
@comment .br
-vvv level 4: level 3 plus events.
@comment TROFF INPUT: .br
@comment .br
-vvvv level 5: level 4 plus events.
@comment TROFF INPUT: .br
@comment .br
-vvvvv level 6: level 5 plus set shell -vx option.
@comment TROFF INPUT: .br
@comment .br
-vvvvvv level 7 and higher: level 6 plus debugging messages.
@comment TROFF INPUT: .br
@comment .br
 The progress meter is suppressed if swcopy is using stdout for data.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-b SIZE}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Set block size, same as @minus{}@minus{}block-size=N (Implementation extension option).
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{@minus{}@minus{}version, -V}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Show version (Implementation extension)
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{@minus{}@minus{}help}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Show help (Implementation extension)
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W option[,option,...]}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Specify the implementation extension option.
@comment TROFF INPUT: .br
@comment .br
Syntax: -W option[=option@t{_}argument[,option...]
@comment TROFF INPUT: .br
@comment .br
Options may be separated by a comma.  The implementation extension
options may also be given individually using the '@minus{}@minus{}long-option[=option@t{_}arg]' syntax.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W no-audit}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Defaults File Option: @b{swbis@t{_}no@t{_}audit}
@comment TROFF INPUT: .br
@comment .br
Do not audit the transferred file.  This allows copying of arbitrary data.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W audit}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Do audit the transferred file.  Useful for overriding swbisdefaults file.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W block-size=SIZE}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

SIZE is number of octets.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W login}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Establishes a interactive shell on the (remote) target host.  Intended for debugging/verifying ssh operation.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W gzip}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Compress output using gzip.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W bzip}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Compress output using bzip2.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W extract}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Install the source using the archive reading utility at the target.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W create}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Force copy as a tar archive
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W no-extract}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

For installation to a file, not as a tar archive to be extracted.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W pty}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Do use pseudo-tty.  The system Ptys are only used for the --login feature.
A warning is emitted to stderr which says that the usage may be insecure.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W no-pty}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Do not use pseudo-tty.  The system Ptys are only used by default for the --login feature, otherwise they
are not used and this option would have no effect.
If ptys are used a warning is emitted to stderr which says that the usage may be insecure.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W uncompress}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Write output archive that is uncompressed.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W remote-shell=SHELL}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Defaults File Option: @b{swbis@t{_}remote@t{_}shell@t{_}client}
@comment TROFF INPUT: .br
@comment .br
Supported shells are "ssh" and "rsh", ssh is the default.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W quiet-progress}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Defaults File Option: @b{swbis@t{_}quiet@t{_}progress@t{_}bar}
@comment TROFF INPUT: .br
@comment .br
Disable progress bar, which is active for verbose levels 2 and higher (i.e. -v).
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W show-progress}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Enables progress bar.(i.e. -v).
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W show-options-files}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Show the complete list of options files and if they are found.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W show-options}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Show the options after reading the files and parsing the command line options.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W pax-command=@{tar|pax|star|gtar@}}
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the portable archive command for all operations.
The default is "pax".
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W pax-read-command=@{tar|pax|star|gtar@}}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the read command for local and remote hosts.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W remote-pax-read-command=@{tar|pax|star|gtar@}}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}remote@t{_}pax@t{_}read@t{_}command}
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the read command for remote hosts.
This is the command that runs on the target (e.g. pax -r, tar xpf -).
The default is "pax".
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W local-pax-read-command=@{tar|pax|star|gtar@}}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}local@t{_}pax@t{_}read@t{_}command}
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the read command for local hosts.
This is the command that runs on the target (e.g. pax -r, tar xpf -).
The default is "pax".
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W pax-write-command=@{tar|pax|star|gtar|swbistar@}}
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the write command for local and remote hosts.
This is the command that runs on the target (e.g. pax -w, tar cf -).
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W remote-pax-write-command=@{tar|pax|star|gtar|swbistar@}}
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}remote@t{_}pax@t{_}write@t{_}command}
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the write command for remote hosts.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W local-pax-write-command=@{tar|pax|star|gtar|swbistar@}}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}local@t{_}pax@t{_}write@t{_}command}
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the portable archive write command for local host operations.
This is the command that runs on the source (e.g. pax -w, tar cf -).
The default is "pax".
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W remote-pax-write-command=@{tar|pax|star|gtar|swbistar@}}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}remote@t{_}pax@t{_}write@t{_}command}
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Set the portable archive write command for remote host operations.
This is the command that runs on the source (e.g. pax -w, tar cf -).
The default is "pax".
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W no-defaults}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Do not read any defaults files.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W no-remote-kill}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}no@t{_}remote@t{_}kill}
@comment TROFF INPUT: .br
@comment .br
Disables the use of a second remote connection to tear down the first in
the event of SIGINT or SIGTERM or SIGPIPE.
Only has effect if the number of ssh hops is greater than 1.
A single host remote connection (ssh hop = 1) never uses a
second remote connection.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W no-getconf}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}no@t{_}getconf}
@comment TROFF INPUT: .br
@comment .br
Makes the remote command be '/bin/sh -s' instead of the default
'PATH=`getconf PATH` sh -s'.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W shell-command=NAME}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}shell@t{_}command}
@comment TROFF INPUT: .br
@comment .br
NAME may be one of "detect" "bash", "sh" or "posix" and specifies the
command run by the remote shell.
The default is "detect".
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W use-getconf}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Opposite of @minus{}@minus{}no-getconf.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W allow-rpm}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Defaults File Option: @b{swbis@t{_}allow@t{_}rpm}
@comment TROFF INPUT: .br
@comment .br
Allows detection and translation of RPMs.  (@minus{}@minus{}audit must also be set.)
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W unrpm}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Turns on options @minus{}@minus{}allow-rpm and @minus{}@minus{}audit.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W source-script-name=NAME}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Write the script that is written into the remote shell's stdin to NAME.
This is useful for debugging.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-W target-script-name=NAME}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
Write the script that is written into the remote shell's stdin to NAME.
This is useful for debugging.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{software@t{_}selections}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Refer to the software objects (products, filesets)
on which to be operated. (Not implemented).
The implementation defined behavior for no selections is to operate on
the entire distribution.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------

@comment TROFF INPUT: .PP

@b{target}
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Refers to the software@t{_}collection where the software
selections are to be applied.  Allows specification of host and pathname where the software collection is located.
A target that contains only one part is assumed to be a hostname.
To force interpretation as a path, use a absolute path or prefix with ':'.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
Source and Target Specification and Logic

     Synopsis:
          Posix:
               host[:path]
               host
               host:
               /path  # Absolute path

          Swbis Extension:
               [user@@]host[:path]
               [user@@]host@t{_}port[:path]
               :path

          Swbis Multi-hop Target Extension:
               # ':' is the target delimiter
	       # '@t{_}' delimits a port number in the host field

               [user@@]host[@@@@[user@@]host[@@@@...]][:file]
               [user@@]host@t{_}port[@@@@[user@@]host[@@@@...]][:file]

               # Using ':', a trailing colon is used to
               # disambiguate between a host and file.
	       # For Example,
               :file
               host:
               host
               host:file
               host:host:
               host@t{_}port:host@t{_}port:
               host:host:file
               user@@host:user@@host:
               user@@host:user@@host:host:
               user@@host:user@@host:file

     A more formal description:

     target : HOST@t{_}CHARACTER@t{_}STRING ':' PATHNAME@t{_}CHARACTER@t{_}STRING
            | HOST@t{_}CHARACTER@t{_}STRING ':'
            | HOST@t{_}CHARACTER@t{_}STRING
            | PATHNAME@t{_}CHARACTER@t{_}STRING
            | ':' PATHNAME@t{_}CHARACTER@t{_}STRING   # Impl extension
            ;

       PATHNAME@t{_}CHARACTER@t{_}STRING must be an absolute path unless
                       a HOST@t{_}CHARACTER@t{_}STRING is given.  Allowing
                       a relative path is a feature of the swbis
                       implementation.

                NOTE: A '.' as a target is an implementation
                      extension and means extract in current
                      directory.

                NOTE: A '-' indicating stdout/stdin is an
                      implementation extension.

                NOTE: A ':' in the first character indicates a filename.
                      This is an implementation extension.

       HOST@t{_}CHARACTER@t{_}STRING is an IP or hostname.

    Examples:
       Copy the  distribution /var/tmp/foo.tar.gz at 192.168.1.10
              swcopy -s /var/tmp/foo.tar.gz @@192.168.1.10:/root


Implementation Extension Syntax (multi ssh-hop) :
    Syntax:
    %start   wtarget    # the Implementation Extension Target
                        # Note: a trailing ':' forces interpretation
                        # as a host, not a file.
    wtarget   : wtarget DELIM sshtarget
              | sshtarget
              | sshtarget DELIM
              ;
    sshtarget : user '@@' target # Note: only the last target
              | target          # may have a PATHNAME, and only a host
              ;                 * may have a user
    target   : HOST@t{_}CHARACTER@t{_}STRING
             | PATHNAME@t{_}CHARACTER@t{_}STRING
             ;
    user     : PORTABLE@t{_}CHARACTER@t{_}STRING  # The user name

    DELIM    : ':'   # The multi-hop delimiter.
             ;  @r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP


@comment TROFF INPUT: .SH "TARGET COPYING RULES"
@c DEBUG: print_menu("OPTIONS")
@comment MAN2TEXI: EON

@node TARGET COPYING RULES

@section TARGET COPYING RULES

@comment TROFF INPUT: .SS "Rules"
@c DEBUG: print_menu("TARGET COPYING RULES")

@ifnottex
@menu
* Rules::
* Examples::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node Rules

@subsection Rules

@comment TROFF INPUT: .PP

If a target directory on the host does not exist it will be created using
mkdir -p using the file creation mask of the originating swcopy process.
A trailing slash in the target spec signifies
that the last path component should be a directory.
A source spec that is a directory will be created on the target as a
directory with the same name in the target directory.
If the source spec is stdin then the existence of directories in the
target spec and a trailing slash in the target spec path determines
whether the created file will be a regular file or directory,
that is, stdin will be copied as a file unless the last target path
component is a directory or ends in a slash '/'.  If the source spec is a
regular file, the source basename will be used as the basename in the
target if the last target path component is a directory or ends in
a slash '/', otherwise,
the target basename is the last path component of the target spec.
The implementation option @minus{}@minus{}extract biases these rules to install using
the archive reading command (e.g.  pax -r).
@comment TROFF INPUT: .SS "Examples"
@comment MAN2TEXI: EON

@node Examples

@subsection Examples

@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation

Copy a regular file via tar archive creation and extraction.
This will preserve the permissions of the file to the extent
tar can preserve them.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display

@comment WARNING: man/man8/swcopy.8:575:%%new font R started without closing previous font R

  swcopy @minus{}@minus{}no-audit --create --extract -s :README @@ HostA}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy a directory to another host
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
  swcopy @minus{}@minus{}no-audit  -s /usr @@ HostA:/usr/local/tmp/HostA/@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy several directories to another host as a compressed archive file.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
    swcopy @minus{}@minus{}no-audit --no-extract \\

@comment WARNING: man/man8/swcopy.8:588:%%new font R started without closing previous font R

             -s /usr -s /etc @@ HostA:/tmp/usr-etc.tar.bz2}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Install a tarball in the current directory:
Note: Must use stdin as source and "." as the target.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
     swcopy @minus{}@minus{}no-audit -s - @@. < foo.tar.gz@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy thru a firewall:
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
            swcopy -s /var/tmp/foo.tar.gz \\

@comment WARNING: man/man8/swcopy.8:602:%%new font R started without closing previous font R

                 @@root@@host1:root@@host2:/var/tmp}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy Stdin to a remote host:
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
    Unpack the archive on stdin in the directory
    /a/b/c if 'c' is a directory, otherwise copy
    the archive file to a file named 'c' in
    directory /a/b creating it if possible and
    overwriting if required.
        swcopy -s - @@host1:/a/b/c@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy Stdin to a remote host:
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
       Unpack the serial archive on stdin in the
       directory /a/b/c if 'c' is a directory,
       otherwise make the directory 'c' but fail if
       directory 'c' cannot be created.
           swcopy -s - @@host1:/a/b/c/

@comment WARNING: man/man8/swcopy.8:626:%%new font R started without closing previous font R

                     # Note trailing slash.}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy a regular file:
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
   Copy file yy to directory /aa/bb/cc/ on the
   remote host, creating it if required and possible.
   If cc is a regular file then fail.
      swcopy -s /xx/yy @@host1:/aa/bb/cc/@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy a regular file thru intermediate host 'fw':
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
       Copy file yy to home directory of user1 on host1
       thru a an intermediate host fw,

@comment WARNING: man/man8/swcopy.8:645:%%new font R started without closing previous font R

           swcopy -s /xx/yy @@ fw:user1@@host1:.}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 Copy a directory from one host to another
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
       Copy directory yy into directory cc if cc exists,
       otherwise create cc and copy yy into it. If cc
       is and copy as yy.
           swcopy -s /xx/yy @@host1:/aa/bb/cc@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .SH "IMPLEMENTATION EXTENSIONS"
@comment MAN2TEXI: EON

@node IMPLEMENTATION EXTENSIONS

@section IMPLEMENTATION EXTENSIONS

@comment TROFF INPUT: .SS "Software Specification Targets"
@c DEBUG: print_menu("IMPLEMENTATION EXTENSIONS")

@ifnottex
@menu
* Software Specification Targets::
* RPM Translation::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node Software Specification Targets

@subsection Software Specification Targets

@comment TROFF INPUT: .PP

A dash '-' is supported and means stdout or stdin.
Operations with stdout and stdin on a remote host is not supported.
@comment TROFF INPUT: .PP

A decimal '.' is supported and means the current directory.
This is supported for remote and non-remote targets.
If the source is standard input, the distribution will be unpacked
(e.g. pax -r) in the directory '.'.
If the source is a regular file then a regular file in '.' will be created
with the same name.
@comment TROFF INPUT: .PP

Thus,
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
           # swcopy -s `pwd`/myarchive.tgz @@.  # Do NOT do this even
                                               # though in most cases

@comment WARNING: man/man8/swcopy.8:676:%%new font R started without closing previous font R

                                               # swcopy is a coward.}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 will destroy the source file myarchive.tgz, whereas
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
           # swcopy -s - @@. <`pwd`/myarchive.tgz@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

 will install it with the configured archive reading utility.


@comment TROFF INPUT: .SS "RPM Translation"
@comment MAN2TEXI: EON

@node RPM Translation

@subsection RPM Translation

@comment TROFF INPUT: .PP

RPM (RedHat Package Manager) format packages are copied by first translating to
an equivalent ISO/IEEE file layout in POSIX tar format and then copying as
a POSIX package.
The RPM detection and translation occurs if the ''@minus{}@minus{}allow-rpm'' option is
on (either by the command line args or defaults file) and the ''--audit'' option
is on.  If the ''--allow-rpm'' option is not set an error occurs.
If the ''--audit'' is not set, the RPM is copied as arbitrary data and translation
does not occur.
@comment TROFF INPUT: .PP

Since translation is done on the local (management) host, RPM is not reqired on
the remote (target) host.
@comment TROFF INPUT: .PP

The translation is (internally) equivalent to :
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
   cat your-poor-poor-0.0.bin.rpm |
   /usr/lib/swbis/lxpsf --psf-form2 -H ustar |

@comment WARNING: man/man8/swcopy.8:707:%%new font R started without closing previous font R

   swpackage -Wsource=- -s@@PSF}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .SH "EXTENDED OPTIONS"
@comment MAN2TEXI: EON

@node EXTENDED OPTIONS

@section EXTENDED OPTIONS

@comment TROFF INPUT: .PP

Extended options can be specified on the command line using the -x option
or from the defaults file, swdefaults.  Shown below is an actual portion of
a defaults file which show default values.
@comment TROFF INPUT: .SS "Posix"
@c DEBUG: print_menu("EXTENDED OPTIONS")

@ifnottex
@menu
* Posix::
* Swbis Implementation::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node Posix

@subsection Posix

@comment TROFF INPUT: .PP

These options are set in the /usr/lib/swbis/swdefaults or the ~/.swdefaults
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
   autoselect@t{_}dependencies     = false      # Not Implemented
   compress@t{_}files              = false      # Not Implemented
   compression@t{_}type            = none       # Not Implemented
   distribution@t{_}source@t{_}directory   = -
   distribution@t{_}target@t{_}directory   = -
   enforce@t{_}dependencies        = false       # Not Implemented
   enforce@t{_}dsa                 = false       # Not Implemented
   logfile                     = /var/lib/sw/swcopy.log #Not Implemented
   loglevel                    = 1          # Not Implemented
   recopy                      = false      # Not Implemented
   select@t{_}local         = false      # Not Implemented
   uncompress@t{_}files             = false     # Not Implemented
   verbose                      = 1@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .SS "Swbis Implementation"
@comment MAN2TEXI: EON

@node Swbis Implementation

@subsection Swbis Implementation

@comment TROFF INPUT: .PP

These options are set in the /usr/lib/swbis/swbisdefaults or the ~/.swbis/swbisdefaults
file.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
  swcopy.swbis@t{_}no@t{_}getconf = true # true or false
  swcopy.swbis@t{_}shell@t{_}command = detect # @{detect|sh|bash|posix|ksh@}
  swcopy.swbis@t{_}no@t{_}remote@t{_}kill = false # true or false
  swcopy.swbis@t{_}no@t{_}audit = false # true or false
  swcopy.swbis@t{_}quiet@t{_}progress@t{_}bar = false # true or false
  swcopy.swbis@t{_}local@t{_}pax@t{_}write@t{_}command=pax #@{pax|tar|star|gtar@}
  swcopy.swbis@t{_}remote@t{_}pax@t{_}write@t{_}command=pax #@{pax|tar|star|gtar@}
  swcopy.swbis@t{_}local@t{_}pax@t{_}read@t{_}command=pax #@{pax|tar|gtar|star@}
  swcopy.swbis@t{_}remote@t{_}pax@t{_}read@t{_}command=pax #@{pax|tar|gtar|star@}
  swcopy.swbis@t{_}allow@t{_}rpm = false  # true or false

@comment WARNING: man/man8/swcopy.8:753:%%new font R started without closing previous font R

  swcopy.swbis@t{_}remote@t{_}shell@t{_}client=ssh}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .SH "RETURN VALUE"
@comment MAN2TEXI: EON

@node RETURN VALUE

@section RETURN VALUE

@comment TROFF INPUT: .PP

0 if all targets succeeded, 1 if all targets failed, 2 if some targets failed and some succeeded.
@comment TROFF INPUT: .SH "NOTES"
@c DEBUG: print_menu("RETURN VALUE")
@comment MAN2TEXI: EON

@node NOTES

@section NOTES

 Multiple ssh-hops is an implementation extension.
@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .SH "REQUISITE UTILITIES"
@c DEBUG: print_menu("NOTES")
@comment MAN2TEXI: EON

@node REQUISITE UTILITIES

@section REQUISITE UTILITIES

@comment TROFF INPUT: .PP

The swbis distributed utilities require
@b{bash}, public domain @b{ksh}, or
Sun's /usr/xpg4/bin/sh to be present on the target host.  If the
@b{swbis@t{_}shell@t{_}command} extended option is set to 'detect'
you don't have to know which one is present, otherwise you may specify one explicitly.
@comment TROFF INPUT: .PP

A POSIX @b{awk} is required, and with the ability to
specify several thousand bytes of program text as a command argument.
GNU awk  works, as does the ATT Awk book awk, and the awk on BSD systems.
See the INSTALL file for further details regarding a small issue with the
OpenSolaris (c.2006) awk.
@comment TROFF INPUT: .PP

Tar or pax is used for archive transfer.  You may specify which one.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
swcopy.swbis@t{_}local@t{_}pax@t{_}write@t{_}command=tar #@{pax|tar|gtar@}
swcopy.swbis@t{_}remote@t{_}pax@t{_}write@t{_}command=tar #@{pax|tar|gtar@}@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .SH "FILES"
@c DEBUG: print_menu("REQUISITE UTILITIES")
@comment MAN2TEXI: EON

@node FILES

@section FILES

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
/usr/lib/swbis/swdefaults
/usr/lib/swbis/swbisdefaults
$HOME/.swbis/swdefaults

@comment WARNING: man/man8/swcopy.8:790:%%new font R started without closing previous font R

$HOME/.swbis/swbisdefaults}
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP


@comment TROFF INPUT: .SH "APPLICABLE STANDARDS"
@c DEBUG: print_menu("FILES")
@comment MAN2TEXI: EON

@node APPLICABLE STANDARDS

@section APPLICABLE STANDARDS

@comment TROFF INPUT: .PP

ISO/IEC 15068-2:1999, Open Group CAE C701
@comment TROFF INPUT: .SH "SEE ALSO"
@c DEBUG: print_menu("APPLICABLE STANDARDS")
@comment MAN2TEXI: EON

@node SEE ALSO

@section SEE ALSO

@comment TROFF INPUT: .PP

info swbis
@comment TROFF INPUT: .PP

sw(5), swbis(7), swbisparse(1), swign(1), swverify(8)
@comment TROFF INPUT: .SH "IDENTIFICATION"
@c DEBUG: print_menu("SEE ALSO")
@comment MAN2TEXI: EON

@node IDENTIFICATION

@section IDENTIFICATION

 swcopy(8): The archive copying utility of the swbis project.
 Author: Jim Lowe   Email: jhlowe at acm.org
 Version: 1.13.1
 Last Updated: 2006-07
 Copying: GNU Free Documentation License
@comment TROFF INPUT: .SH "BUGS"
@c DEBUG: print_menu("IDENTIFICATION")
@comment MAN2TEXI: EON

@node BUGS

@section BUGS

@comment TROFF INPUT: .PP

Swcopy is subject to breakage if a user's account on an intermediate
(or terminal) host in a target spec is not configured to use a Bourne
compatible shell. (This breakage may be eliminated by use of the
--no-getconf option as explained above.)
@comment TROFF INPUT: .PP

A multiple ssh hop source spec  (more than 1 remote host involved in the
source transfer) upon a SIGINT may result in sshd and ssh processes
being left on on the intermediate host(s), this despite, swcopy's action of
sending a SIGTERM to the remote script's parent process.
@comment TROFF INPUT: .PP

Swcopy does not currently implement Software Selections nor the events of the
Selection and Analysis Phases nor dependency copying nor fileset state
transitions.  The Execution (copying) phase is done on the entire
distribution by the utility selected in .../swbisdefaults which is pax(1) by
default.  Pax is not found on all GNU/Linux systems.
Also, the pax version shipped with some (older) GNU/Linux systems mangles the pathname
of files whose pathname is exactly 100 octets long.
Despite this pax is the the builtin default.
GNU tar is widely used and trusted but creates non-standard archives for long
pathnames.  Perhaps the best compromise is to use star (with -H ustar header
option)  for archive creation and (GNU) tar for archive reading.
If your environment is 100% GNU/Linux using GNU tar is safe (GNU tar 1.13.25 is
recommended).
Swcopy does not support using the cpio utility since its archive writing
interface is unlike pax and tar, although, future support is possible for
archive reading.
@comment  created by instant / docbook-to-man, Fri 02 Nov 2018, 20:39
@bye
