SDIST(8)

NAME
sdist - distribute files to a set of hosts

SYNOPSIS
sdist [-ARScgnqrsvyz] [-D destdir] [-M maxparallel] [-d var=value] [-f hostfile] [-h host] [-l logopts] [-o longoptions] [-t timeout] [-x extra-rdist-clause] [files or directories]

DESCRIPTION
The sdist command invokes rdist(1) in an intelligent manner. Usually sdist is invoked from the master distribution host.

Invoking the command without any arguments will distribute the current working directory to all hosts in the netgroup for the platform you are running sdist on. The name of the group is ``dist-os-rel-arch'' where os, rel and arch are derived from the output of osname(1).

sdist will read /etc/sdist.conf for local default overrides if it exists.

If files or directories are specified on the command line, those directories will be distributed instead of the current directory. Any file or directory names are first converted to absolute pathnames on the local machine before being distributed.

The options are:

-A  Distribute worldwide by first distributing to ``dist-os-rel-arch-masters'' and then running the same sdist command on each of them.

-D  The following argument is used as the destination directory. This causes relocation of the directory that's being distributed, so care is advised when using this option.

-M  The following argument is the maximum number of parallel processes spawned by rdist(1).

-R  Remove extraneous files.

-S  Use srsh(1) to create connections to remote hosts.

-c  Leave out the rel component from the netgroup name. This can be used to distribute files common to different releases of an operating system. See also -g.

-d  The following argument sets a variable.

-f  The following argument specifies a file listing the hosts or netgroups to use in place of the default netgroup.

-g  Leave out the arch component from the netgroup name. This can be used to distribute files common to different architectures of an operating system. See also -c.

-h  The following argument specifies a host or netgroup to use in place of the default netgroup.

-n  Only check the distfile, do not run rdist(1).

-l  The following argument is the logging options described in rdist(1).

-o  The following argument sets various long options, see the rdist(1) manual page.

-q  Run rdist(1) in quiet mode. Do not display the files being updated.

-r  Convenience alias for -R.

-s  Convenience alias for -S.

-t  The following argument is used as a timeout passed to rdist(1) (which defaults to 900 seconds). The default timeout in sdist is 120 seconds.

-v  Dummy run -- do not really update or install the files, just print what would happen.

-x  The following argument adds an additional clause to the generated distfile, see the rdist(1) manual page.

-y  Run rdist(1) in younger mode. Do not update remote copies that are younger than the master copy, but issue a warning message instead.

-z  Use compression on the transferred data (good for slow links).

FILES

/etc/sdist.conf

SEE ALSO
osname(1), rdist(1), ssync(1), srsh(1), uname(1)

AUTHORS
David Siegel, Mark Moraes, Kimmo Suominen and Christos Zoulas.