SYNOPSIS
lapply [-CFiInrV] [ -% | -q | -v ] [ -c checksum ] [ -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 com-
pression-level ] { apply-able-transcript }
DESCRIPTION
lapply 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.
-h host specifies the radmind server, by default _RAD-
MIND_HOST.
-i force output linebuffering.
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 _RADMIND_AUTH-
LEVEL. 0 = no TLS, 1 = server verification, 2 =
server and client verification.
-x ca-pem-file Certificate authority's public certificate, by
default _RADMIND_TLS_CA. The default is not used
when -P is specified.
-y cert-pem-file Client's public certificate, by default _RAD-
MIND_TLS_CERT.
-z private-key-file
Client's private key, by default _RADMIND_TLS_CERT.
-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 ALSO
fsdiff(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).
Man(1) output converted with
man2html