lapply(1) User Commands lapply(1)NAMElapply - modify file system to match apply-able-transcript
SYNOPSISlapply [-CFiInrV] [ -% | -q | -v ] [ -c checksum ] [ -e event ] [
-h host ] [ -p port ] [ -P ca-pem-directory ] [ -u umask ] [ -w auth-
level ] [ -x ca-pem-file ] [ -y cert-pem-file ] [ -z private-key-file ]
[ -Z compression-level ] { apply-able-transcript }
DESCRIPTIONlapply reads an apply-able transcript line-by-line, modifying the file
system to match the transcript. Transcript lines are applied in order
unless they are directories marked for deletion. In such cases, subse‐
quent transcript lines are first applied until the file system object
listed is outside of the directory. If another directory marked for
deletion is encountered, the process is started recursively.
lapply downloads missing files indicated by a "+" from the radmind
server host. file is applied to the system with the attributes as
described in the transcript line. File system objects marked with a
"-" are removed. Other transcript lines indicate that a file system
object must be modified or created if missing. lapply is not able to
create doors or sockets.
File system objects listed in the transcript and present in the file
system as a different type are automatically removed.
By default, lapply will exit with an error if an object's full path is
not present on the file system. When run with the -C option, lapply
will attempt to create any intermediate directories that are missing.
Intermediated directories inherit the owner, group and permissions of
its parent directory.
The radmind tools are unaware of user defined file flags, some of which
may prevent lapply from successfully completing. Using the -F option,
lapply will remove all user defined flags.
If apply-able-transcript is not given, lapply will use the standard
input for reading.
lapply is also capable of decoding applefiles stored on the server by
lcreate(1), restoring the files' Mac OS HFS+ metadata to the client
machine. (Mac OS X, HFS+-formatted drives only.)
OPTIONS
-% percentage done progress output.
-c checksum enables checksuming.
-C create missing intermediate directories.
-e event the event type to report. This is limited to a sin‐
gle word, containing no white space. By default this
is "lapply".
-h host specifies the radmind server, by default radmind.
-i force output linebuffering.
-I be case insensitive when comparing paths.
-F remove all user defined flags for a file if they
exist.
-n no network connection will be made, causing only
file system removals and updates to be applied.
auth-level is implicitly set to 0.
-p port specifies the port of the radmind server, by default
6222.
-P ca-pem-directory
specifies a directory that contains certificates to
be used when verifying the server. Certificates
must be in PEM format and the directory must have
been processed with the openssl c_rehash utility.
-q suppress all messages.
-r use random seed file $RANDFILE if that environment
variable is set, $HOME/.rnd otherwise. See
RAND_load_file(3o).
-u umask specifies the umask for temporary files, by default
0077
-V displays the version number of lapply and exits.
-v displays communication with the radmind server.
-w auth-level TLS authorization level, by default 0. 0 = no TLS,
1 = server verification, 2 = server and client veri‐
fication.
-x ca-pem-file Certificate authority's public certificate, by
default /var/radmind/cert/ca.pem. The default is
not used when -P is specified.
-y cert-pem-file Client's public certificate, by default /var/rad‐
mind/cert/cert.pem.
-z private-key-file
Client's private key, by default /var/rad‐
mind/cert/cert.pem.
-Z compression-level
Compress all outbound data. compression-level can
be between 0 and 9: 1 gives best speed, 9 gives best
compression, 0 gives no compression at all (the
input data is simply copied a block at a time).
EXIT STATUS
The following exit values are returned:
0 Transcript was applied.
1 An error occurred, system was modified.
2 An error occurred, system was not modified.
SEE ALSOfsdiff(1), ktcheck(1), lcksum(1), lcreate(1), lfdiff(1), lmerge(1),
lsort(1), twhich(1), applefile(5), radmind(8), chflags(2),
RAND_load_file(3o).
RSUG December 12, 2010 lapply(1)