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).