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

FreeBSD Manual Pages

  
 
  

home | help
MKLTFS(8)	      IBM Storage Archive Command Reference	       MKLTFS(8)

NAME
     mkltfs - Format a tape in the drive to LTFS format

SYNOPSIS
     mkltfs -d name [ -f ]  [ -s id ]  [ -n name ]  [ -r rules ]  [ -w ]  [ -q ]
     [ -t ]  [ -V ]  [ -h ]  [ -p ]

DESCRIPTION
     mkltfs is a program to format a media for use with the IBM Storage Archive.

OPTIONS
     These  programs follow the usual GNU command line syntax, with long options
     starting with two dashes ('-'). A summary of options is included below. For
     a complete description, see the Info files.

     -d, --device=name
	    Tape device name (required). On Linux, name is like '/dev/IBMtape0',
	    on OSX, name is like '0'

     -f, --force
	    Force to format medium

     -s, --tape-serial=id
	    Tape serial number (6 alphanumeric ASCII characters)

     -n, --volume-name=name
	    Tape volume name (empty by default)

     -r, --rules=rules
	    Rules for choosing files to write to the index partition.  The  syn-
	    tax of the rule argument is:

	    size=1M

	    size=1M/name=pattern

	    size=1M/name=pattern1:pattern2:pattern3

	    A file is written to the index partition if it is no larger than the
	    given  size AND matches at least one of the name patterns (if speci-
	    fied). The size argument accepts K, M, and G suffixes. Name patterns
	    might contain the special characters '?' (match any  single  charac-
	    ter) and '*' (match zero or more characters).

     --no-override
	    Disallow mount-time data placement policy changes

     -w, --wipe
	    Restore  the  LTFS	medium	to  an unpartitioned medium (format to a
	    legacy scratch medium)

     -q, --quiet
	    Suppress progress information and general messages

     -t, --trace
	    Enable function call tracing

     --syslogtrace
	    Enable diagnostic output to stderr and syslog

     -V, --version
	    Version information

     -h, --help
	    Show help information

     -p, --advanced-help
	    Full help, including advanced options

   USAGE EXAMPLE
	       /home/piste/ltfs05-sde/bin/mkltfs --device=/dev/IBMtape0 --rules="size=100K"
	       /home/piste/ltfs05-sde/bin/mkltfs --device=/dev/IBMtape0 --rules="size=1M/name=*.jpg"
	       /home/piste/ltfs05-sde/bin/mkltfs --device=/dev/IBMtape0 --rules="size=1M/name=*.jpg:*.png"

ADVANCED OPTIONS (EXPERIMENTAL)
     The options described here is experimental functions.

     These programs follow the usual GNU command line syntax, with long  options
     starting with two dashes ('-'). A summary of options is included below. For
     a complete description, see the Info files.

     -i, --config=name
	    Use the specified configuration file (default: )

     -e, --backend=name
	    Use the specified tape device backend (default: )

     --kmi-backend=name
	    Use the specified key manager interface backend (default: none)

     -b, --blocksize=num
	    Set the LTFS record size (default: 524288)

     -c, --no-compression
	    Disable compression on the volume

     -k, --keep-capacity
	    Keep the tape medium's total capacity proportion

     -x, --fulltrace
	    Enable full function call tracing (slow)

     --long-wipe
	    Unformat  the  medium  and erase any data on the tape by overwriting
	    special data pattern.  This operation takes over 3 hours.  Once  you
	    start, you cannot interrupt it.

     --destructive
	    Use destructive format/unformat. This operation takes longer time in
	    the LTO9 drive or later because of the media optimization procedure.

SEE ALSO
     ltfs-sde(8), ltfsck(8), tape-backend(4), kmi-backend(4), ltfs.conf(5).

IBM Storage Archive		08 February 2022		       MKLTFS(8)

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

home | help