GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LAPPLY (1)

NAME

lapply - modify file system to match apply-able-transcript

CONTENTS

Synopsis
Description
Options
Exit Status
See Also

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).
Search for    or go to Top of page |  Section 1 |  Main Index


RSUG LAPPLY (1) December 12, 2010

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.