Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
lcreate(1)			  User Commands 		      lcreate(1)

NAME
     lcreate -	upload transcripts and their corresponding files

SYNOPSIS
     lcreate  [-FilnNrTV] [ -% | -q | -v ] [ -c checksum ] [ -h host ] [ -p port
     ] [ -P ca-pem-directory ] [ -t stored-name ] [ -U user ] [ -w auth-level  ]
     [	-x ca-pem-file	] [ -y cert-pem-file ] [ -z private-key-file ] [ -Z com-
     pression-level ] create-able-transcript

DESCRIPTION
     lcreate reads and uploads a transcript and all corresponding files  to  the
     radmind server.

     lcreate  verifies the size listed in the transcript with the actual size of
     the file and stops on any differences.  If the -F option is given,  lcreate
     will store the file on the server and give a warning.

     If  the -n option is given, no files or transcripts are uploaded.	Instead,
     lcreate uses access(2) to verify that all files in the transcript exist  in
     the  filesystem,  are readable by the user and have the same size as listed
     in the transcript.  If used with the -c option,  rather  than  calling  ac-
     cess(2), checksums are caluclated to verify file contents and user access.

     If  the  -N option is given, indicating the transcript specified for upload
     is negative, lcreate will upload all corresponding files as zero length.

     If the -T option is given, lcreate will upload the transcript only. No cor-
     responding files will be uploaded. The transcript's stored name is, by  de-
     fault, the last part ( after the slash ) of the given path, or as specified
     by the name given with the -t option.  lcreate will print ( to the standard
     output  )	the entire protocol exchange with the radmind server when the -v
     option is given.

     By default, lcreate displays the percentage of bytes processed in a  format
     that can be passed directly to iHook.

     lcreate stores a Macintosh HFS+ file's data and corresponding metadata in a
     single  applefile(5)  on  the  server.   With the -N option, applefiles are
     stored with a zero length resource fork, zero length data fork and  a  cre-
     ator type of RDMD.  Systems running Mac OS X on UFS-formatted drives do not
     need this special support.

OPTIONS
     -% 		percentage done progress output.

     -c checksum	enables checksuming.

     -F 		ignore file size differences.

     -h hostname	specifies the radmind server, by default radmind.

     -i 		force output linebuffering.

     -l 		Turn on user authentication.  Requires a TLS.

     -N 		uploads  a  negative  transcript then uploads all corre-
			sponding files as zero length.

     -n 		Don't upload any files or transcripts.	Verify all files
			in the transcript exist in the filesystem and  have  the
			size listed in the transcript.

     -p port		specifies a port, 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 vari-
			able	 is	set,	$HOME/.rnd    otherwise.     See
			RAND_load_file(3o).

     -T 		uploads the transcript only, and not  the  corresponding
			files.

     -t stored-name	specifies  the	name  under which the transcript will be
			stored when saved on the server.

     -U user		Specifes the user for user authentication.  By	default,
			the login name returned by getlogin() will be used.

     -V 		displays  the  version	of lcreate, a list  of supported
			checksumming algorithms in descending order  of  prefer-
			ence and then exits.

     -v 		increase  the  verbosity.  -v produces one line for each
			file stored on the server.  -vv displays all  communica-
			tion 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/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 com-
			pression, 0 gives no compression at all (the input  data
			is simply copied a block at a time).

SEE ALSO
     fsdiff(1),   ktcheck(1),	lapply(1),   lcksum(1),   lfdiff(1),  lmerge(1),
     lsort(1), twhich(1), applefile(5), radmind(8), RAND_load_file(3o).

RSUG				October 06, 2023		      lcreate(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lcreate&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help