DragonFly On-Line Manual Pages
lapply(1) User Commands lapply(1)
NAME
lapply - modify file system to match apply-able-transcript
SYNOPSIS
lapply [-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
}
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,
subsequent 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
single 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
verification.
-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/radmind/cert/cert.pem.
-z private-key-file
Client's private key, by default
/var/radmind/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 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).
RSUG December 12, 2010 lapply(1)