--- truecrypt/linux/cli/man/truecrypt.1 2018/04/24 16:45:59 1.1.1.4 +++ truecrypt/linux/cli/man/truecrypt.1 2018/04/24 16:47:49 1.1.1.6 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. -.TH TRUECRYPT "1" "July 2006" "truecrypt 4.2a" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. +.TH TRUECRYPT "1" "May 2007" "truecrypt 4.3a" "User Commands" .SH NAME truecrypt - manage TrueCrypt volumes .SH SYNOPSIS @@ -37,13 +37,13 @@ VOLUME_PATH [MOUNT_DIRECTORY] .IP Open a TrueCrypt volume specified by VOLUME_PATH and map it as a block device /dev/mapper/truecryptN. N is the first available device number if not -otherwise specified with \fB\-N\fR. To map a hidden volume, specify its password +otherwise specified with \fB\-N\fR. Filesystem of the mapped volume is mounted at +MOUNT_DIRECTORY if specified. To open a hidden volume, specify its password and/or keyfiles (the outer volume cannot be mapped at the same time). -Filesystem of the mapped volume is mounted at MOUNT_DIRECTORY if specified. -See also options \fB\-\-display\-password\fR, \fB\-\-filesystem\fR, \fB\-k\fR, \fB\-M\fR, \fB\-p\fR, \fB\-P\fR, +See also EXAMPLES and options \fB\-\-display\-password\fR, \fB\-\-filesystem\fR, \fB\-k\fR, \fB\-M\fR, \fB\-p\fR, \fB\-P\fR, \fB\-\-password\-tries\fR, \fB\-r\fR, \fB\-u\fR, \fB\-\-update\-time\fR. Note that passing some of the options -may affect security or plausible deniability. See options \fB\-i\fR and \fB\-p\fR for more -information. +may affect security (see options \fB\-i\fR and \fB\-p\fR for more information). +This command requires administrator privileges (sudo(8) is used if available). .PP \fB\-\-backup\-headers\fR BACKUP_FILE [VOLUME_PATH] .IP @@ -52,8 +52,7 @@ Volume path is requested from user if no normal/outer and hidden volume headers are stored in the backup file even if there is no hidden volume within the volume (to preserve plausible deniability). When restoring the volume header, it is possible to select -which header is to be restored. Note that this command drops effective user -ID. See also \fB\-\-restore\-header\fR. +which header is to be restored. See also \fB\-\-restore\-header\fR. .PP \fB\-c\fR, \fB\-\-create\fR [VOLUME_PATH] .IP @@ -64,11 +63,10 @@ filesystem on the outer volume. Hidden v should be used to update the outer volume contents after the hidden volume is created. WARNING: To prevent data corruption, you should follow the instructions in the EXAMPLES section on how to create a hidden volume. -Note that this command drops effective user ID. See also options \fB\-\-cluster\fR, \fB\-\-disable\-progress\fR, \fB\-\-display\-keys\fR, \fB\-\-encryption\fR, \fB\-k\fR, \fB\-\-filesystem\fR, \fB\-\-hash\fR, \fB\-p\fR, \fB\-\-random\-source\fR, \fB\-\-quick\fR, \fB\-\-size\fR, -\fB\-\-type\fR. Note that passing some of the options may affect security or plausible -deniability. See option \fB\-p\fR for more information. +\fB\-\-type\fR. Note that passing some of the options may affect security (see option +\fB\-p\fR for more information). .PP \fB\-C\fR, \fB\-\-change\fR [VOLUME_PATH] .IP @@ -82,6 +80,7 @@ algorithm can be changed with option \fB Dismount and unmap mapped volumes. If MAPPED_VOLUME is not specified, all volumes are dismounted and unmapped. See below for a description of MAPPED_VOLUME. +This command requires administrator privileges (sudo(8) is used if available). .PP \fB\-h\fR, \fB\-\-help\fR .IP @@ -89,9 +88,9 @@ Display help information. .PP \fB\-i\fR, \fB\-\-interactive\fR .IP -Map and mount a volume interactively. Options which may affect security or -plausible deniability are requested from the user. See option \fB\-p\fR for more -information. +Map and mount a volume interactively. Options which may affect security are +requested from the user. See option \fB\-p\fR for more information. +This command requires administrator privileges (sudo(8) is used if available). .PP \fB\-l\fR, \fB\-\-list\fR [MAPPED_VOLUME] .IP @@ -99,11 +98,12 @@ Display a list of mapped volumes. If MAP volumes are listed. By default, the list contains only volume path and mapped device name pairs. A more detailed list can be enabled by verbose output option (\fB\-v\fR). See below for a description of MAPPED_VOLUME. +This command requires administrator privileges (sudo(8) is used if available). .PP \fB\-\-keyfile\-create\fR FILE .IP Create a new keyfile using the random number generator. FILE argument specifies -the output file. Note that this command drops effective user ID. +the output file. .PP \fB\-\-properties\fR [VOLUME_PATH] .IP @@ -114,8 +114,7 @@ Display properties of a volume specified Restore header of a volume specified by VOLUME_PATH from a file BACKUP_FILE. Volume path is requested from user if not specified on command line. Type of the restored volume header (normal/hidden) is requested from user if -not specified with \fB\-\-type\fR. Note that this command drops effective user ID. -See also \fB\-\-backup\-headers\fR. +not specified with \fB\-\-type\fR. See also \fB\-\-backup\-headers\fR. .PP \fB\-\-test\fR .IP @@ -123,7 +122,7 @@ Test all internal algorithms used in the .PP \fB\-V\fR, \fB\-\-version\fR .IP -Display version information. +Display program version and legal notices. .SS "MAPPED_VOLUME:" .IP Specifies a mapped or mounted volume. One of the following forms can be used: @@ -173,7 +172,7 @@ and/or keyfiles. Use specified keyfile to open a volume to be mapped (or when changing password and/or keyfiles). When a directory is specified, all files inside it will be used (non\-recursively). Additional keyfiles can be specified with multiple \fB\-k\fR -options. Empty keyfile (\fB\-k\fR ) disables interactive requests for keyfiles +options. Empty keyfile (\fB\-k\fR '') disables interactive requests for keyfiles (e.g., when creating a new volume). See also option \fB\-K\fR. .PP \fB\-K\fR, \fB\-\-keyfile\-protected\fR FILE | DIRECTORY @@ -191,7 +190,7 @@ volume. See EXAMPLES for more informatio \fB\-M\fR, \fB\-\-mount\-options\fR OPTIONS .IP Filesystem mount options. The OPTIONS argument is passed to mount(8) -command with option \fB\-o\fR. +command with option \fB\-o\fR. See also options \fB\-r\fR and \fB\-u\fR. .PP \fB\-N\fR, \fB\-\-device\-number\fR N .IP @@ -206,7 +205,7 @@ Overwrite files without prompting the us .IP Use specified password to open a volume. Additional passwords can be specified with multiple \fB\-p\fR options. An empty password can also be specified -("" in most shells). Note that passing a password on the command line is +('' in most shells). Note that passing a password on the command line is potentially insecure as the password may be visible in the process list (see ps(1)) and/or stored in a command history file. .PP @@ -257,16 +256,16 @@ header. TYPE can be 'normal' or 'hidden' .PP \fB\-u\fR, \fB\-\-user\-mount\fR .IP -Set default user and group ID of the filesystem being mounted to the user and -group ID of the process which executed TrueCrypt. Some filesystems (like FAT) -do not support user permissions and, therefore, it is necessary to supply a -default user and group ID to the system when mounting such filesystems. +Make a volume being mounted accessible in a non\-administrator account. Some +filesystems (e.g., FAT) do not support Unix\-style access control and it is +necessary to use this option when mounting them. Ownership of the mounted +filesystem is determined by environment variables set by sudo(8) command. +Note that Unix\-style filesystems (e.g., ext2) do not support this option. .PP \fB\-\-update\-time\fR .IP -Do not preserve access and modification timestamps of volume containers and -access timestamps of keyfiles. By default, timestamps are restored after -a volume is unmapped or after a keyfile is closed. +Do not preserve access and modification timestamps of file containers. +By default, timestamps are restored after a volume is unmapped. .PP \fB\-v\fR, \fB\-\-verbose\fR .IP @@ -282,7 +281,7 @@ truecrypt \fB\-u\fR /dev/hda2 /mnt/tc .IP Map a volume /dev/hda2 (first ATA disk, primary partition 2) and mount its filesystem at /mnt/tc. Default user\-id is set, which is useful when mounting -a filesystem like FAT under a non\-admin user account. +a filesystem, such as FAT, for use in a non\-administrative account. .PP truecrypt \fB\-i\fR .IP @@ -312,7 +311,7 @@ truecrypt \fB\-P\fR /dev/hdc1 /mnt/tc .IP Map and mount outer volume /dev/hdc1 and protect hidden volume within it. .PP -truecrypt \fB\-p\fR "" \fB\-p\fR "" \fB\-k\fR key1 \fB\-k\fR key2 \fB\-K\fR key_hidden \fB\-P\fR volume.tc +truecrypt \fB\-p\fR '' \fB\-p\fR '' \fB\-k\fR key1 \fB\-k\fR key2 \fB\-K\fR key_hidden \fB\-P\fR volume.tc .IP Map outer volume ./volume.tc and protect hidden volume within it. The outer volume is opened with keyfiles ./key1 and ./key2 and the @@ -366,8 +365,8 @@ cp outer_volume_file.txt /mnt/tc truecrypt \fB\-d\fR volume.tc .IP 6) If a warning message has been displayed in 5), start again from 1). Either -a larger outer volume should be created in 1), or smaller files should be -copied to the outer volume in 4). +a larger outer volume should be created in 1), or less data should be copied +to the outer volume in 4). .SH DIAGNOSTICS Exit status .B 0 @@ -379,19 +378,17 @@ is returned. Kernel module reports error .SH "REPORTING BUGS" Report bugs at . .SH COPYRIGHT -Copyright \(co 2004-2006 TrueCrypt Foundation. All Rights Reserved. +Copyright \(co 2003-2007 TrueCrypt Foundation. All Rights Reserved. .br Copyright \(co 1998-2000 Paul Le Roux. All Rights Reserved. .br -Copyright \(co 2004 TrueCrypt Team. All Rights Reserved. -.br -Copyright \(co 1999-2005 Dr. Brian Gladman. All Rights Reserved. +Copyright \(co 1999-2006 Dr. Brian Gladman. All Rights Reserved. .br Copyright \(co 1995-1997 Eric Young. All Rights Reserved. .br Copyright \(co 2001 Markus Friedl. All Rights Reserved. .PP -Released under the TrueCrypt Collective License 1.0 +Released under the TrueCrypt Collective License 1.2 .SH "SEE ALSO" .B http://www.truecrypt.org/docs/ .br