
@node Configuring swbis
@chapter How to configure swbis

@pindex sample
@cindex invoking @command{swbis}

The configuration file is called a defaults file.  The defaults file contains
extended options which also can be specified using the '-x' option.

There are two (2) defaults files, the POSIX file named @file{swdefaults} and the
swbis specific file named @file{swbisdefaults}.  The swbis extension options all
begin with "swbis_".

For GNU/Linux users the following changes to the config files are
recommended:
 
@verbatim
swbis_local_pax_write_command  = tar  # {pax|tar|star|gtar|swbistar}
swbis_remote_pax_write_command = tar  # {pax|tar|star|gtar|swbistar}
swbis_local_pax_read_command   = tar  # {pax|tar|star|gtar}
swbis_remote_pax_read_command  = tar  # {pax|tar|star|gtar}
swbis_no_getconf               = true # true or false
swbis_shell_command            = bash # {sh|bash|posix|ash|ksh}
swbis_allow_rpm                = true
swcopy.swbis_no_audit          = true # true or false
@end verbatim

The files are located in two places, in the package library directory such as
@file{/usr/lib/swbis}, and in the user's home directory in the 
@file{.swbis} directory.

To show these locations:
@example
         swinstall --show-options-files
@end example

To show the options:
@example
         swinstall --show-options
@end example

To show the compiled in defaults if no defaults files are read:
@example
         swinstall --no-defaults --show-options
@end example

@ifnottex
@menu
* swdefaults configuration file::
* swbisdefaults configuration file::
* Archive Reading/Writing Utility Selection::
* Shell Selection::
@end menu
@end ifnottex

@node swdefaults configuration file
@unnumberedsec swdefaults
@verbatiminclude ../../etc/swdefaults

@node swbisdefaults configuration file
@unnumberedsec swbisdefaults
@verbatiminclude ../../etc/swbisdefaults


@node Archive Reading/Writing Utility Selection
@unnumberedsec Archive Reading/Writing Utility Selection

Users of GNU/Linux systems might find the default utility, pax, especially
annoying or even non-existent.
Therefore, editing the @file{/usr/lib/swbis/swbisdefaults} file might be in order:

@verbatim
swbis_local_pax_write_command  = tar  # {pax|tar|star|gtar|swbistar}
swbis_remote_pax_write_command = tar  # {pax|tar|star|gtar|swbistar}
swbis_local_pax_read_command   = tar  # {pax|tar|star|gtar}
swbis_remote_pax_read_command  = tar  # {pax|tar|star|gtar}
@end verbatim

@node Shell Selection
@unnumberedsec Shell Selection

Use in networks where there are only GNU/Linux and BSD systems may allow
these changes to @file{/usr/lib/swbis/swbisdefaults}.
These changes will likely break operation on Sun Solaris hosts (as well as other non GNU hosts)
since use of @command{getconf} is needed to locate the POSIX shell.
These changes, however, simplify the command invoked on the remote host.
@verbatim
swbis_no_getconf               = true # true or false
swbis_shell_command            = bash # {sh|bash|posix|ash|ksh}
@end verbatim


