\input texinfo   @c -*-texinfo-*-
@setfilename swconfig.info
@comment direntry.in
@dircategory Individual utilities
@direntry
* swconfig: (swbis).               list POSIX format packages
@end direntry
@comment ===============================================================
@comment WARNING: Do NOT edit this file.  It was produced automatically
@comment by man2info on Sun May 22 09:15:06 EDT 2016
@comment for jhl@
@comment from man/man8/swconfig.8
@comment in /home/jhl/swbis-1.13x/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: /sources/swbis/swbis/doc/texi/swbis_swconfig.texi,v 1.15 2016/05/22 13:52:39 jhlowe Exp $
@comment ...\" $Header: /sources/swbis/swbis/doc/texi/swbis_swconfig.texi,v 1.15 2016/05/22 13:52:39 jhlowe 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/swconfig.8:49:%%unrecognized define-string command: [.ds f1\"]

@comment TROFF INPUT: .ds f2\"

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

@comment TROFF INPUT: .ds f3\"

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

@comment TROFF INPUT: .ds f4\"

@comment WARNING: man/man8/swconfig.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 "swconfig" "8"

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

@node Top

@chapter swconfig" "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::
* USAGE EXAMPLES::
* 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

swconfig @r{---} Configure installed software
@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{swconfig}  [-p] [-u]  [-c @i{catalog}] [-f @i{file}] [-t @i{targetfile}] \\
[-x @i{option=value}]  [-X @i{options@t{_}file}]  [-W @i{option}] \\
[software@t{_}selections]  [@@targets]
@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{swconfig} configures, unconfigures, and reconfigures installed software on a host.
@b{swconfig} is a distributed utility.
Neither swconfig 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

@b{swconfig} operates on installed software and performs configuration primarily by executing the @b{configure} or @b{unconfigure}
control scirpts.  If these scripts do not exists for an installed package, then swconfig takes no action.
@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

Read the list of software selections from FILE.
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

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

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

Preview mode, establish contact with target host, however, modify nothing.
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

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

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

Undo, run the unconfigure script.
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

@b{-c catalog}
@comment TROFF INPUT: .RS

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

Specify a file of PSF or INDEX syntax or a directory containing the exported catalog.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
@b{Note:  This option is not yet implemented.
@comment TROFF INPUT: .RE

@end quotation

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

@end quotation

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

@comment TROFF INPUT: .PP


@comment WARNING: man/man8/swconfig.8:119:%%new font B started without closing previous font B

}@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{-v}
@comment TROFF INPUT: .RS

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

Increment the verbose level.
@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{@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{--postinstall}
@comment TROFF INPUT: .RS

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

run the @b{postinstall} or @b{unpostinstall} script
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

@b{--force-locks}
@comment TROFF INPUT: .RS

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

override locking and delete existing lock
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

@b{--send-environment}
@comment TROFF INPUT: .RS

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

Include existing environment variables in the remote host's execution environment.
System and common varaiables are excluded and checks are made for tainted values.
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

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

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

Allows swconfig to act on all matching entries.  Without this option
a software selection that matches more than one installed software entry
is an error.
@comment TROFF INPUT: .RE

@end quotation

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

@comment TROFF INPUT: .PP

@b{--sig-level=N}
@comment TROFF INPUT: .RS

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

Specify number of required GPG signatures, N equal to 0 means don't
require the catalog to be signed.
@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 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-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 "bash", "sh" or "posix" and specifies the
remote command run by the remote shell.
"posix" is 'PATH=`getconf PATH` sh -s', "bash" is "/bin/bash -s",
"sh" is "/bin/sh -s", and "ksh" is "ksh -s".
The default is "posix".
@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 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)
using software spec syntax. (See sw(5) for syntax).
@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 "USAGE EXAMPLES"
@c DEBUG: print_menu("OPTIONS")
@comment MAN2TEXI: EON

@node USAGE EXAMPLES

@section USAGE EXAMPLES

@comment TROFF INPUT: .SS "Run the configure script for package foo on 192\&.168\&.1\&.2:/"
@c DEBUG: print_menu("USAGE EXAMPLES")

@ifnottex
@menu
* Run the configure script for package foo on 192 168 1 2 - /::
* Show the options::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node Run the configure script for package foo on 192 168 1 2 - /

@subsection Run the configure script for package foo on 192.168.1.2:/

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

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

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

  swconfig foo @@ root@@192.168.1.2:/}
@comment TROFF INPUT: .fi

@end display

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


@comment TROFF INPUT: .SS "Show the options"
@comment MAN2TEXI: EON

@node Show the options

@subsection Show the options

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
  swconfig --show-options@r{
@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 on
the local (management host, host where swconfig is invoked).
These files on the target host are not used.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
  allow@t{_}incompatible            = false # Not implemented
  allow@t{_}multiple@t{_}versions       = false # Not implemented
  ask                           = false # Not implemented
  autoselect@t{_}dependencies       = true # Not implemented
  autoselect@t{_}dependents         = true # Not implemented
  enforce@t{_}dependencies          = true # Not implemented
  installed@t{_}software@t{_}catalog    = var/lib/swbis/catalog/
  logfile                       = /var/log/sw.log
  loglevel                      = 1
  select@t{_}local                  = true # Not implemented
  reconfigure                   = false

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

  verbose                       = 1}
@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
   swconfig.swbis@t{_}no@t{_}getconf = true # true or false
  swconfig.swbis@t{_}shell@t{_}command = posix # @{sh|bash|posix|ksh@}
  swconfig.swbis@t{_}no@t{_}remote@t{_}kill = false # true or false
  swconfig.swbis@t{_}local@t{_}pax@t{_}write@t{_}command=tar #@{pax|tar|star|gtar@}
  swconfig.swbis@t{_}remote@t{_}pax@t{_}write@t{_}command=tar #@{pax|tar|star|gtar@}
  swconfig.swbis@t{_}local@t{_}pax@t{_}read@t{_}command=tar #@{pax|tar|gtar|star@}
  swconfig.swbis@t{_}remote@t{_}pax@t{_}read@t{_}command=tar #@{pax|tar|gtar|star@}
  swconfig.swbis@t{_}local@t{_}pax@t{_}remove@t{_}command=tar
  swconfig.swbis@t{_}remote@t{_}pax@t{_}remove@t{_}command=tar
  swconfig.swbis@t{_}remote@t{_}shell@t{_}client=ssh
  swconfig.swbis@t{_}forward@t{_}agent=True
  swconfig.swbis@t{_}sig@t{_}level=0
  swconfig.swbis@t{_}enforce@t{_}all@t{_}signatures=false@r{
@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 or internal error, 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

@comment WARNING: man/man8/swconfig.8:516:%%new font B started without closing previous font R

}@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

GNU Privacy Guard, gpg is required for verification of package signatures.
@comment TROFF INPUT: .PP

Other utilities required to be in $PATH on the remote host are:
dd, pax (or tar|star|gtar), mkdir, echo, test, sleep, read (if not builtin).
@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
/var/lib/swbis/catalog # Location of installed catalog
/usr/lib/swbis/swdefaults
/usr/lib/swbis/swbisdefaults
$HOME/.swbis/swdefaults
$HOME/.swbis/swbisdefaults@r{
@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

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

@node IDENTIFICATION

@section IDENTIFICATION

 swconfig(8): The package configuration utility of the swbis project.
 Author: Jim Lowe   Email: jhlowe at acm.org
 Version: 1.13
 Last Updated: 2010-01-22
 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

This section is left intentionally black
@comment  created by instant / docbook-to-man, Sun 22 May 2016, 09:15
@bye
