From f2f0e690db008447a230628762679108d1d9e72b Mon Sep 17 00:00:00 2001 From: JinWang An Date: Mon, 26 Dec 2022 13:14:06 +0900 Subject: [PATCH] Imported Upstream version 3.0.28 --- .gitignore | 7 + ChangeLog | 314 ++++++++++++++++++++++++++++++++++++++- Makefile | 10 +- VERSION | 2 +- manpages/Makefile | 3 +- manpages/de/fatlabel.de.8 | 40 +++-- manpages/de/fsck.fat.de.8 | 150 ++++++++++--------- manpages/de/mkfs.fat.de.8 | 192 ++++++++++++------------ manpages/en/fatlabel.8 | 37 +++-- manpages/en/fsck.fat.8 | 175 +++++++++++++++------- manpages/en/mkfs.fat.8 | 183 +++++++++++++++++------ manpages/po/de/fatlabel.8.po | 81 ++++++---- manpages/po/de/fsck.fat.8.po | 317 ++++++++++++++++++++------------------- manpages/po/de/mkfs.fat.8.po | 344 ++++++++++++++++++++++++------------------- manpages/pot/fatlabel.8.pot | 81 ++++++---- manpages/pot/fsck.fat.8.pot | 317 ++++++++++++++++++++------------------- manpages/pot/mkfs.fat.8.pot | 344 ++++++++++++++++++++++++------------------- src/boot.c | 20 +-- src/check.c | 73 +++++---- src/common.c | 6 +- src/common.h | 8 +- src/fat.c | 14 +- src/file.c | 9 +- src/file.h | 2 + src/fsck.fat.c | 10 +- src/fsck.fat.h | 156 ++++++++++---------- src/io.c | 1 - src/lfn.c | 23 +-- src/mkfs.fat.c | 235 ++++++++++++++--------------- src/msdos_fs.h | 61 ++++++++ src/version.h | 4 +- 31 files changed, 1979 insertions(+), 1240 deletions(-) create mode 100644 src/msdos_fs.h diff --git a/.gitignore b/.gitignore index 384f131..2dc4ca9 100644 --- a/.gitignore +++ b/.gitignore @@ -2,3 +2,10 @@ /fatlabel /fsck.fat /mkfs.fat + +tags +*~ +.*.sw[a-p] +*.orig +*.rej +*.DS_Store diff --git a/ChangeLog b/ChangeLog index 8616201..f6a1e3d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,4 +1,316 @@ -commit e2c8f06 (HEAD, origin/master, master) +commit ad1342e +Author: Andreas Bombe +Date: Sat May 16 02:10:18 2015 +0200 + + manpages: Mark MT and ME tags as untranslated for po4a + + Signed-off-by: Andreas Bombe + +commit 3ed9ec2 +Author: Andreas Bombe +Date: Sun May 10 19:59:02 2015 +0200 + + mkfs: Small changes to FAT32 cluster size selection + + Put the cluster size selection back in line with the table used in + Microsoft's fatgen103.pdf and fix the comment. This only involved + changing some comparison operators, all values stayed the same. + + Signed-off-by: Andreas Bombe + +commit 9984552 +Author: Andreas Bombe +Date: Mon Apr 20 23:41:34 2015 +0200 + + fsck: Mention -r is default in usage message + + Signed-off-by: Andreas Bombe + +commit 3eaca68 +Author: Andreas Bombe +Date: Mon Apr 20 23:30:56 2015 +0200 + + manpages: Remove obsolete information about Linux FAT support + + Signed-off-by: Andreas Bombe + +commit a5e34de +Author: Andreas Bombe +Date: Thu Apr 16 23:16:08 2015 +0200 + + manpages: Convert the rest of argument placeholders to upper case + + Signed-off-by: Andreas Bombe + +commit 2303765 +Author: Andreas Bombe +Date: Thu Apr 16 22:51:20 2015 +0200 + + manpages: Fix formatting + + Make the manpages conform to the rules for groff sources. First, + eliminate empty lines because these create vertical spaces where it + isn't desired. Man page sources should not contain empty lines. Second, + put a line break between sentences in a paragraph. A period is + recognized and formatted as a full stop period only when a line break + comes right after it. + + Signed-off-by: Andreas Bombe + +commit d3969b8 +Author: Andreas Bombe +Date: Fri Apr 10 20:32:50 2015 +0200 + + fsck: Verify first cluster of a file is not 1 + + Previously the FAT was checked for any out of bounds entries which were + cleared. However the first cluster of a file, as specified in its + directory entry, was not verified to not be 1. + + In addition to missing this filesystem error, code that correctly + assumes the FAT contained no bad entries anymore could still look up + invalid table indices depending on the value stored in entry 1. With + the right values and FAT size this can lead to a segfault by accessing + unallocated memory. + + Now test_file() will ignore files where the first cluster equals 1 and + an additional check in check_file() will truncate them. + + This bug was reported in http://bugs.debian.org/773885 by Jakub Wilk. + + Signed-off-by: Andreas Bombe + +commit 2a56575 +Author: Andreas Bombe +Date: Thu Apr 2 23:35:00 2015 +0200 + + Simplify synopses of man pages + + Since there is only one mode of invocation for the tools, it is + somewhat pointless to list every possible option in the synopsis. + + Fix a few style inconsistencies in addition, specifically that + placeholders for option arguments are in capital letters and should be + shown where the option is described. + + Signed-off-by: Andreas Bombe + +commit 40f1436 +Author: Andreas Bombe +Date: Wed Apr 1 20:55:58 2015 +0200 + + Update homepage and maintainer sections of man pages + + Signed-off-by: Andreas Bombe + +commit 0169db8 +Author: Andreas Bombe +Date: Wed Apr 1 20:05:01 2015 +0200 + + mkfs: Show a clearer message that file already exists with -C + + Signed-off-by: Andreas Bombe + +commit 2967e27 +Author: Andreas Bombe +Date: Mon Mar 30 21:12:51 2015 +0200 + + mkfs: Remove O_TRUNC from file creation call + + open() is called with O_EXCL | O_CREAT, so it will definitely create a + new, empty file or error out. O_TRUNC is superfluous and may be harmless + in practice but its effect under these circumstances is unspecified. + + Signed-off-by: Andreas Bombe + +commit 90612df +Author: Andreas Bombe +Date: Mon Mar 30 21:09:51 2015 +0200 + + mkfs: Use ftruncate() for expanding created file + + Signed-off-by: Andreas Bombe + +commit 58e8e09 +Author: Andreas Bombe +Date: Tue Mar 24 21:32:40 2015 +0100 + + mkfs: Add --invariant option + + The --invariant option is designed to prevent random or time based + differences to end up in generated filesystems so that multiple runs + generate on the same file or device create completely identical results. + + This is intended for debugging or regression testing of mkfs.fat. + + Signed-off-by: Andreas Bombe + +commit 354feaf +Author: Andreas Bombe +Date: Thu Mar 19 21:35:21 2015 +0100 + + mkfs: Add long option parsing + + Add long option parsing with getopt_long() to mkfs and define --help as + the first long option. The usage() function now takes an exit code + parameter so that the --help option handling can exit the program with + a success exit code. + + Signed-off-by: Andreas Bombe + +commit b611549 +Author: Andreas Bombe +Date: Mon Mar 16 21:08:35 2015 +0100 + + Do not expect EOF as return value of getopt() + + Signed-off-by: Andreas Bombe + +commit a41fc32 +Author: Andreas Bombe +Date: Wed Mar 11 21:45:04 2015 +0100 + + fsck.fat: Fix read beyond end of array on FAT12 + + When a FAT12 filesystem contains an odd number of clusters, setting the + last cluster with set_fat() will trigger a read of the next entry, + which does not exist in the fat array allocated for this. + + Round up the allocation to an even number of FAT entries for FAT12 so + that this is fixed without introducing special casing in get_fat(). + + Signed-off-by: Andreas Bombe + +commit e18d72f +Author: Álvaro Fernández Rojas +Date: Sat Mar 7 13:23:23 2015 +0100 + + Remove linux/msdos_fs.h includes + + Signed-off-by: Álvaro Fernández Rojas + Signed-off-by: Andreas Bombe + +commit 245d0cc +Author: Álvaro Fernández Rojas +Date: Thu Feb 26 19:22:54 2015 +0100 + + Remove non standard int types + + Signed-off-by: Álvaro Fernández Rojas + Signed-off-by: Andreas Bombe + +commit 628b3ec +Author: Álvaro Fernández Rojas +Date: Thu Feb 26 19:41:19 2015 +0100 + + Improve .gitignore + + Signed-off-by: Álvaro Fernández Rojas + Signed-off-by: Andreas Bombe + +commit 02b5a6d +Author: Álvaro Fernández Rojas +Date: Thu Feb 26 12:51:23 2015 +0100 + + Makefile: avoid using install -D + + OS X and FreeBSD are not compatible with this option + + Signed-off-by: Álvaro Fernández Rojas + Signed-off-by: Andreas Bombe + +commit fb6aea6 +Author: Álvaro Fernández Rojas +Date: Thu Feb 26 12:50:57 2015 +0100 + + Makefile: fix typo in uninstall-man + + Signed-off-by: Álvaro Fernández Rojas + Signed-off-by: Andreas Bombe + +commit 357ab07 +Author: Andreas Bombe +Date: Thu Feb 19 21:22:54 2015 +0100 + + fsck.fat: Make -r option default + + Default mode is now to interactively repair with the option to write + the changes back at the end (like the -r option) instead of the previous + default mode of interactively correcting but never writing back the + changes. + + The -r option continues to be recognized by fsck.fat. + + Signed-off-by: Andreas Bombe + +commit 266a5fc +Author: Andreas Bombe +Date: Fri Feb 20 03:19:28 2015 +0100 + + mkfs.fat: Allow 0xF0 to be specified as media byte + + Let the -M option accept 0xF0, which should be the proper descriptor + byte for 3.5" 1.44 MB and 2.88 MB floppies. + + Also split the error reporting for -M between badly formatted and + invalid numbers. + + Signed-off-by: Andreas Bombe + +commit 16e97e9 +Author: Andreas Bombe +Date: Wed Jan 28 15:07:18 2015 +0100 + + Make all char* that may take literals const + + Every char* variable or function argument that may be given a literal + string is now made const. Additionally add -Wwrite-strings to CFLAGS to + enable a warning where const would be missing. + + Signed-off-by: Andreas Bombe + +commit 8b8948c +Author: Andreas Bombe +Date: Mon Dec 29 18:24:54 2014 +0100 + + mkfs.fat.c: Use unsigned char for binary data + + Simple char technically works for the dummy_boot_jump variables, but + some compiler warning settings would give a warning over a signed char + overflowing with the values given as initializers. + + Signed-off-by: Andreas Bombe + +commit 45aeed0 +Author: Andreas Bombe +Date: Sun Nov 16 19:49:22 2014 +0100 + + Fix indentation of "fix power loss damage" commit + + I fixed the (sometimes misleading) indentation of the code introduced in + commit 6893c45 to be in line with the reset of the code and also removed + the /* PATCH ED+DL */ comments which are quite meaningless to the wider + world. + + Signed-off-by: Andreas Bombe + +commit 75c5446 +Author: Andreas Bombe +Date: Sat Nov 15 16:48:48 2014 +0100 + + Add tags and editor backup files to .gitignore + + Signed-off-by: Andreas Bombe + +commit cb98ae2 (tag: v3.0.27) +Author: Andreas Bombe +Date: Wed Nov 12 01:10:23 2014 +0100 + + Releasing version 3.0.27. + + Signed-off-by: Andreas Bombe + +commit e2c8f06 Author: Andreas Bombe Date: Wed Nov 12 00:22:17 2014 +0100 diff --git a/Makefile b/Makefile index 81256ef..1593f3d 100644 --- a/Makefile +++ b/Makefile @@ -30,7 +30,7 @@ MANDIR = $(PREFIX)/share/man #OPTFLAGS = -O2 -fomit-frame-pointer -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 OPTFLAGS = -O2 -fomit-frame-pointer -D_GNU_SOURCE $(shell getconf LFS_CFLAGS) #WARNFLAGS = -Wall -pedantic -std=c99 -WARNFLAGS = -Wall -Wextra -Wno-sign-compare -Wno-missing-field-initializers -Wmissing-prototypes -Wstrict-prototypes +WARNFLAGS = -Wall -Wextra -Wno-sign-compare -Wno-missing-field-initializers -Wmissing-prototypes -Wstrict-prototypes -Wwrite-strings DEBUGFLAGS = -g CFLAGS += $(OPTFLAGS) $(WARNFLAGS) $(DEBUGFLAGS) @@ -62,7 +62,8 @@ install-man: for MANPAGE in manpages/en/*; \ do \ SECTION="8"; \ - install -D -m 0644 $${MANPAGE} $(DESTDIR)/$(MANDIR)/man$${SECTION}/$$(basename $${MANPAGE}); \ + mkdir -p $(DESTDIR)/$(MANDIR)/man$${SECTION}/; \ + install -m 0644 $${MANPAGE} $(DESTDIR)/$(MANDIR)/man$${SECTION}/$$(basename $${MANPAGE}); \ done for LANGUAGE in $(LANGUAGES); \ @@ -70,7 +71,8 @@ install-man: for MANPAGE in manpages/$${LANGUAGE}/*; \ do \ SECTION="8"; \ - install -D -m 0644 $${MANPAGE} $(DESTDIR)/$(MANDIR)/$${LANGUAGE}/man$${SECTION}/$$(basename $${MANPAGE} .$${LANGUAGE}.$${SECTION}).$${SECTION}; \ + mkdir -p $(DESTDIR)/$(MANDIR)/$${LANGUAGE}/man$${SECTION}/; \ + install -m 0644 $${MANPAGE} $(DESTDIR)/$(MANDIR)/$${LANGUAGE}/man$${SECTION}/$$(basename $${MANPAGE} .$${LANGUAGE}.$${SECTION}).$${SECTION}; \ done; \ done install-symlinks: install-bin install-man @@ -127,7 +129,7 @@ uninstall-man: for MANPAGE in manpages/en/*; \ do \ SECTION="8"; \ - rm -f $(DESTDIR)/$(MANDIR}/man$${SECTION}/$$(basename $${MANPAGE} .en.$${SECTION}).$${SECTION}; \ + rm -f $(DESTDIR)/$(MANDIR)/man$${SECTION}/$$(basename $${MANPAGE} .en.$${SECTION}).$${SECTION}; \ done for LANGUAGE in $(LANGUAGES); \ diff --git a/VERSION b/VERSION index d0ecf17..0baec4d 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -3.0.27 +3.0.28 diff --git a/manpages/Makefile b/manpages/Makefile index 28b29fa..ee8a478 100644 --- a/manpages/Makefile +++ b/manpages/Makefile @@ -38,7 +38,8 @@ build: po4a.cfg exit 1; \ fi - po4a --keep 0 --no-backups --package-name dosfstools po4a.cfg + po4a --keep 0 --no-backups -o untranslated=MT,ME \ + --package-name dosfstools po4a.cfg clean: rm -rf $(LANGUAGES) diff --git a/manpages/de/fatlabel.de.8 b/manpages/de/fatlabel.de.8 index d819a13..53f5515 100644 --- a/manpages/de/fatlabel.de.8 +++ b/manpages/de/fatlabel.de.8 @@ -24,37 +24,45 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FATLABEL 8 2014\-11\-12 3.0.27 dosfstools - +.TH FATLABEL 8 2015\-05\-16 3.0.28 dosfstools .SH NAME +.\" ---------------------------------------------------------------------------- \fBfatlabel\fP \- set or get MS\-DOS filesystem label - .SH SYNOPSIS +.\" ---------------------------------------------------------------------------- \fBfatlabel\fP \fIDEVICE\fP [\fILABEL\fP] - .SH DESCRIPTION \fBfatlabel\fP set or gets a MS\-DOS filesystem label from a given device. .PP -If the label is omitted, then the label name of the specified device is -written on the standard output. A label can't be longer than 11 bytes. - +.\" ---------------------------------------------------------------------------- +If \fILABEL\fP is omitted, then the label name of the specified device is +written on the standard output. A label can't be longer than 11 bytes. .SH OPTIONS .IP "\fB\-h\fP, \fB\-\-help\fP" 4 Displays a help message. .IP "\fB\-V\fP, \fB\-\-version\fP" 4 +.\" ---------------------------------------------------------------------------- Shows version. - .SH "SEE ALSO" \fBfsck.fat\fP(8) .br +.\" ---------------------------------------------------------------------------- \fBmkfs.fat\fP(8) - .SH HOMEPAGE -More information about \fBfatlabel\fP and \fBdosfstools\fP can be found at -<\fIhttp://daniel\-baumann.ch/software/dosfstools/\fP>. - +.\" ---------------------------------------------------------------------------- +The home for the \fBdosfstools\fP project is its +.UR https://github.com/dosfstools/dosfstools +GitHub project page +.UE . .SH AUTHORS -\fBdosfstools\fP were written by Werner Almesberger -<\fIwerner.almesberger@lrc.di.epfl.ch\fP>, Roman Hodek -<\fIRoman.Hodek@informatik.uni\-erlangen.de\fP>, and others. The current -maintainer is Daniel Baumann <\fImail@daniel\-baumann.ch\fP>. +\fBdosfstools\fP were written by +.MT werner.almesberger@\:lrc.di.epfl.ch +Werner Almesberger +.ME , +.MT Roman.Hodek@\:informatik.\:uni-erlangen.de +Roman Hodek +.ME , +and others. The current maintainer is +.MT aeb@\:debian.org +Andreas Bombe +.ME . diff --git a/manpages/de/fsck.fat.de.8 b/manpages/de/fsck.fat.de.8 index 1d96e23..869b806 100644 --- a/manpages/de/fsck.fat.de.8 +++ b/manpages/de/fsck.fat.de.8 @@ -24,95 +24,94 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FSCK.FAT 8 2014\-11\-12 3.0.27 dosfstools - +.TH FSCK.FAT 8 2015\-05\-16 3.0.28 dosfstools .SH NAME +.\" ---------------------------------------------------------------------------- \fBfsck.fat\fP \- check and repair MS\-DOS filesystems - .SH SYNOPSIS -\fBfsck.fat\fP|\fBfsck.msdos\fP|\fBfsck.vfat\fP [\-aAflnprtvVwy] [\-d \fIPATH\fP \-d\ \&\fI...\fP] [\-u\ \fIPATH\fP \-u \fI...\fP] \fIDEVICE\fP - +.\" ---------------------------------------------------------------------------- +\fBfsck.fat\fP [\fIOPTIONS\fP] \fIDEVICE\fP .SH DESCRIPTION \fBfsck.fat\fP verifies the consistency of MS\-DOS filesystems and optionally tries to repair them. .PP The following filesystem problems can be corrected (in this order): .IP * 4 -FAT contains invalid cluster numbers. Cluster is changed to EOF. +FAT contains invalid cluster numbers. Cluster is changed to EOF. .IP * 4 -File's cluster chain contains a loop. The loop is broken. +File's cluster chain contains a loop. The loop is broken. .IP * 4 -Bad clusters (read errors). The clusters are marked bad and they are removed -from files owning them. This check is optional. +Bad clusters (read errors). The clusters are marked bad and they are +removed from files owning them. This check is optional. .IP * 4 -Directories with a large number of bad entries (probably corrupt). The +Directories with a large number of bad entries (probably corrupt). The directory can be deleted. .IP * 4 -Files . and .. are non\-directories. They can be deleted or renamed. +Files . and .. are non\-directories. They can be deleted or renamed. .IP * 4 -Directories . and .. in root directory. They are deleted. +Directories . and .. in root directory. They are deleted. .IP * 4 -Bad filenames. They can be renamed. +Bad filenames. They can be renamed. .IP * 4 -Duplicate directory entries. They can be deleted or renamed. +Duplicate directory entries. They can be deleted or renamed. .IP * 4 -Directories with non\-zero size field. Size is set to zero. +Directories with non\-zero size field. Size is set to zero. .IP * 4 -Directory . does not point to parent directory. The start pointer is +Directory . does not point to parent directory. The start pointer is adjusted. .IP * 4 -Directory .. does not point to parent of parent directory. The start pointer -is adjusted. +Directory .. does not point to parent of parent directory. The start +pointer is adjusted. .IP * 4 -Start cluster number of a file is invalid. The file is truncated. +Start cluster number of a file is invalid. The file is truncated. .IP * 4 -File contains bad or free clusters. The file is truncated. +File contains bad or free clusters. The file is truncated. .IP * 4 -File's cluster chain is longer than indicated by the size fields. The file +File's cluster chain is longer than indicated by the size fields. The file is truncated. .IP * 4 -Two or more files share the same cluster(s). All but one of the files are -truncated. If the file being truncated is a directory file that has already +Two or more files share the same cluster(s). All but one of the files are +truncated. If the file being truncated is a directory file that has already been read, the filesystem check is restarted after truncation. .IP * 4 -File's cluster chain is shorter than indicated by the size fields. The file +File's cluster chain is shorter than indicated by the size fields. The file is truncated. .IP * 4 -Clusters are marked as used but are not owned by a file. They are marked as +Clusters are marked as used but are not owned by a file. They are marked as free. .PP Additionally, the following problems are detected, but not repaired: .IP * 4 -Invalid parameters in boot sector. +Invalid parameters in boot sector .IP * 4 Absence of . and .. entries in non\-root directories .PP +.\" ---------------------------------------------------------------------------- When \fBfsck.fat\fP checks a filesystem, it accumulates all changes in memory -and performs them only after all checks are complete. This can be disabled +and performs them only after all checks are complete. This can be disabled with the \fB\-w\fP option. - .SH OPTIONS .IP \fB\-a\fP 4 -Automatically repair the filesystem. No user intervention is -necessary. Whenever there is more than one method to solve a problem, the -least destructive approach is used. +Automatically repair the filesystem. No user intervention is necessary. +Whenever there is more than one method to solve a problem, the least +destructive approach is used. .IP \fB\-A\fP 4 -Use Atari variation of the MS\-DOS filesystem. This is default if \fBfsck.fat\fP -is run on an Atari, then this option turns off Atari format. There are some -minor differences in Atari format: Some boot sector fields are interpreted -slightly different, and the special FAT entries for end\-of\-file and bad -cluster can be different. Under MS\-DOS 0xfff8 is used for EOF and Atari -employs 0xffff by default, but both systems recognize all values from -0xfff8...0xffff as end\-of\-file. MS\-DOS uses only 0xfff7 for bad clusters, -where on Atari values 0xfff0...0xfff7 are for this purpose (but the standard -value is still 0xfff7). +Use Atari variation of the MS\-DOS filesystem. This is default if +\fBfsck.fat\fP is run on an Atari, then this option turns off Atari format. +There are some minor differences in Atari format: Some boot sector fields +are interpreted slightly different, and the special FAT entries for +end\-of\-file and bad cluster can be different. Under MS\-DOS 0xfff8 is used +for EOF and Atari employs 0xffff by default, but both systems recognize all +values from 0xfff8...0xffff as end\-of\-file. MS\-DOS uses only 0xfff7 for bad +clusters, where on Atari values 0xfff0...0xfff7 are for this purpose (but +the standard value is still 0xfff7). .IP \fB\-b\fP 4 Make read\-only boot sector check. -.IP \fB\-d\fP 4 -Delete the specified file. If more that one file with that name exists, the -first one is deleted. +.IP "\fB\-d\fP \fIPATH\fP" 4 +Delete the specified file. If more than one file with that name exist, the +first one is deleted. This option can be given more than once. .IP \fB\-f\fP 4 -Salvage unused cluster chains to files. By default, unused clusters are +Salvage unused cluster chains to files. By default, unused clusters are added to the free disk space except in auto mode (\fB\-a\fP). .IP \fB\-l\fP 4 List path names of files being processed. @@ -120,33 +119,31 @@ List path names of files being processed. No\-operation mode: non\-interactively check for errors, but don't write anything to the filesystem. .IP \fB\-p\fP 4 -Same as (\fB\-a\fP), for compatibility with other *fsck. +Same as \fB\-a\fP, for compatibility with other *fsck. .IP \fB\-r\fP 4 -Interactively repair the filesystem. The user is asked for advice whenever -there is more than one approach to fix an inconsistency. +Interactively repair the filesystem. The user is asked for advice whenever +there is more than one approach to fix an inconsistency. This is the +default mode and the option is only retained for backwards compatibility. .IP \fB\-t\fP 4 Mark unreadable clusters as bad. -.IP \fB\-u\fP 4 -Try to undelete the specified file. \fBfsck.fat\fP tries to allocate a chain of -contiguous unallocated clusters beginning with the start cluster of the -undeleted file. +.IP "\fB\-u\fP \fIPATH\fP" 4 +Try to undelete the specified file. \fBfsck.fat\fP tries to allocate a chain +of contiguous unallocated clusters beginning with the start cluster of the +undeleted file. This option can be given more than once. .IP \fB\-v\fP 4 -Verbose mode. Generates slightly more output. +Verbose mode. Generates slightly more output. .IP \fB\-V\fP 4 -Perform a verification pass. The filesystem check is repeated after the -first run. The second pass should never report any fixable errors. It may +Perform a verification pass. The filesystem check is repeated after the +first run. The second pass should never report any fixable errors. It may take considerably longer than the first pass, because the first pass may have generated long list of modifications that have to be scanned for each disk read. .IP \fB\-w\fP 4 Write changes to disk immediately. .IP \fB\-y\fP 4 +.\" ---------------------------------------------------------------------------- Same as \fB\-a\fP (automatically repair filesystem) for compatibility with other fsck tools. -.PP -\fBNote:\fP If \fB\-a\fP and \fB\-r\fP are absent, the filesystem is only checked, but -not repaired. - .SH "EXIT STATUS" .IP 0 4 No recoverable errors have been detected. @@ -154,30 +151,39 @@ No recoverable errors have been detected. Recoverable errors have been detected or \fBfsck.fat\fP has discovered an internal inconsistency. .IP 2 4 -Usage error. \fBfsck.fat\fP did not access the filesystem. - +.\" ---------------------------------------------------------------------------- +Usage error. \fBfsck.fat\fP did not access the filesystem. .SH FILES .IP "fsck0000.rec, fsck0001.rec, ..." 4 +.\" ---------------------------------------------------------------------------- When recovering from a corrupted filesystem, \fBfsck.fat\fP dumps recovered data into files named 'fsckNNNN.rec' in the top level directory of the filesystem. - .SH BUGS -Does not create . and .. files where necessary. Does not remove entirely -empty directories. Should give more diagnostic messages. Undeleting files +.\" ---------------------------------------------------------------------------- +Does not create . and .. files where necessary. Does not remove entirely +empty directories. Should give more diagnostic messages. Undeleting files should use a more sophisticated algorithm. - .SH "SEE ALSO" \fBfatlabel\fP(8) .br +.\" ---------------------------------------------------------------------------- \fBmkfs.fat\fP(8) - .SH HOMEPAGE -More information about \fBfsck.fat\fP and \fBdosfstools\fP can be found at -<\fIhttp://daniel\-baumann.ch/software/dosfstools/\fP>. - +.\" ---------------------------------------------------------------------------- +The home for the \fBdosfstools\fP project is its +.UR https://github.com/dosfstools/dosfstools +GitHub project page +.UE . .SH AUTHORS -\fBdosfstools\fP were written by Werner Almesberger -<\fIwerner.almesberger@lrc.di.epfl.ch\fP>, Roman Hodek -<\fIRoman.Hodek@informatik.uni\-erlangen.de\fP>, and others. The current -maintainer is Daniel Baumann <\fImail@daniel\-baumann.ch\fP>. +\fBdosfstools\fP were written by +.MT werner.almesberger@\:lrc.di.epfl.ch +Werner Almesberger +.ME , +.MT Roman.Hodek@\:informatik.\:uni-erlangen.de +Roman Hodek +.ME , +and others. The current maintainer is +.MT aeb@\:debian.org +Andreas Bombe +.ME . diff --git a/manpages/de/mkfs.fat.de.8 b/manpages/de/mkfs.fat.de.8 index 5a6eb1a..a1b51d4 100644 --- a/manpages/de/mkfs.fat.de.8 +++ b/manpages/de/mkfs.fat.de.8 @@ -24,141 +24,149 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MKFS.FAT 8 2014\-11\-12 3.0.27 dosfstools - +.TH MKFS.FAT 8 2015\-05\-16 3.0.28 dosfstools .SH NAME +.\" ---------------------------------------------------------------------------- \fBmkfs.fat\fP \- create an MS\-DOS filesystem under Linux - .SH SYNOPSIS -\fBmkfs.fat\fP [\fB\-a\fP] [\fB\-A\fP] [\fB\-b\fP \fIsector\-of\-backup\fP] [\fB\-c\fP] [\fB\-l\fP -\fIfilename\fP] [\fB\-C\fP] [\fB\-f\fP \fInumber\-of\-FATs\fP] [\fB\-F\fP \fIFAT\-size] [\fP\fB\-h\fP -\fInumber\-of\-hidden\-sectors\fP] [\fB\-i\fP \fIvolume\-id\fP] [\fB\-I\fP] [\fB\-m\fP -\fImessage\-file\fP] [\fB\-n\fP \fIvolume\-name\fP] [\fB\-r\fP \fIroot\-dir\-entries\fP] [\fB\-R\fP -\fInumber\-of\-reserved\-sectors\fP] [\fB\-s\fP \fIsectors\-per\-cluster\fP] [\fB\-S -\fP\fIlogical\-sector\-size\fP] [\fB\-D\fP \fIdrive\-number\fP] [\fB\-M \fP\fIFAT\-media\-type\fP] -[\fB\-v\fP] \fIdevice\fP [\fIblock\-count\fP] - +.\" ---------------------------------------------------------------------------- +\fBmkfs.fat\fP [\fIOPTIONS\fP] \fIDEVICE\fP [\fIBLOCK\-COUNT\fP] .SH DESCRIPTION +.\" ---------------------------------------------------------------------------- \fBmkfs.fat\fP is used to create an MS\-DOS filesystem under Linux on a device -(usually a disk partition). \fIdevice\fP is the special file corresponding to -the device (e.g /dev/sdXX). \fIblock\-count\fP is the number of blocks on the -device. If omitted, \fBmkfs.fat\fP automatically determines the filesystem +(usually a disk partition). \fIDEVICE\fP is the special file corresponding to +the device (e.g. /dev/sdXX). \fIBLOCK\-COUNT\fP is the number of blocks on the +device. If omitted, \fBmkfs.fat\fP automatically determines the filesystem size. - .SH OPTIONS .IP \fB\-a\fP 4 Normally, for any filesystem except very small ones, \fBmkfs.fat\fP will align all the data structures to cluster size, to make sure that as long as the partition is properly aligned, so will all the data structures in the -filesystem. This option disables alignment; this may provide a handful of +filesystem. This option disables alignment; this may provide a handful of additional clusters of storage at the expense of a significant performance degradation on RAIDs, flash media or large\-sector hard disks. .IP "\fB \-A\fP" 4 -Use Atari variation of the MS\-DOS filesystem. This is default if \fBmkfs.fat\fP -is run on an Atari, then this option turns off Atari format. There are some -differences when using Atari format: If not directed otherwise by the user, -\fBmkfs.fat\fP will always use 2 sectors per cluster, since GEMDOS doesn't like -other values very much. It will also obey the maximum number of sectors -GEMDOS can handle. Larger filesystems are managed by raising the logical -sector size. Under Atari format, an Atari\-compatible serial number for the -filesystem is generated, and a 12 bit FAT is used only for filesystems that -have one of the usual floppy sizes (720k, 1.2M, 1.44M, 2.88M), a 16 bit FAT -otherwise. This can be overridden with the \fB\-F\fP option. Some PC\-specific -boot sector fields aren't written, and a boot message (option \fB\-m\fP) is -ignored. -.IP "\fB\-b\fP \fIsector\-of\-backup\fP" 4 -Selects the location of the backup boot sector for FAT32. Default depends on -number of reserved sectors, but usually is sector 6. The backup must be +Use Atari variation of the MS\-DOS filesystem. This is default if +\fBmkfs.fat\fP is run on an Atari, then this option turns off Atari format. +There are some differences when using Atari format: If not directed +otherwise by the user, \fBmkfs.fat\fP will always use 2 sectors per cluster, +since GEMDOS doesn't like other values very much. It will also obey the +maximum number of sectors GEMDOS can handle. Larger filesystems are managed +by raising the logical sector size. Under Atari format, an Atari\-compatible +serial number for the filesystem is generated, and a 12 bit FAT is used only +for filesystems that have one of the usual floppy sizes (720k, 1.2M, 1.44M, +2.88M), a 16 bit FAT otherwise. This can be overridden with the \fB\-F\fP +option. Some PC\-specific boot sector fields aren't written, and a boot +message (option \fB\-m\fP) is ignored. +.IP "\fB\-b\fP \fISECTOR\-OF\-BACKUP\fP" 4 +Selects the location of the backup boot sector for FAT32. Default depends +on number of reserved sectors, but usually is sector 6. The backup must be within the range of reserved sectors. .IP \fB\-c\fP 4 Check the device for bad blocks before creating the filesystem. .IP \fB\-C\fP 4 -Create the file given as \fIdevice\fP on the command line, and write the -to\-be\-created filesystem to it. This can be used to create the new +Create the file given as \fIDEVICE\fP on the command line, and write the +to\-be\-created filesystem to it. This can be used to create the new filesystem in a file instead of on a real device, and to avoid using \fBdd\fP -in advance to create a file of appropriate size. With this option, the -\fIblock\-count\fP must be given, because otherwise the intended size of the -filesystem wouldn't be known. The file created is a sparse file, which +in advance to create a file of appropriate size. With this option, the +\fIBLOCK\-COUNT\fP must be given, because otherwise the intended size of the +filesystem wouldn't be known. The file created is a sparse file, which actually only contains the meta\-data areas (boot sector, FATs, and root -directory). The data portions won't be stored on the disk, but the file -nevertheless will have the correct size. The resulting file can be copied +directory). The data portions won't be stored on the disk, but the file +nevertheless will have the correct size. The resulting file can be copied later to a floppy disk or other device, or mounted through a loop device. -.IP "\fB\-D\fP \fIdrive\-number\fP" 4 -Specify the BIOS drive number to be stored in the FAT boot sector. This +.IP "\fB\-D\fP \fIDRIVE\-NUMBER\fP" 4 +Specify the BIOS drive number to be stored in the FAT boot sector. This value is usually 0x80 for hard disks and 0x00 for floppy devices or partitions to be used for floppy emulation. -.IP "\fB\-f\fP \fInumber\-of\-FATs\fP" 4 -Specify the number of file allocation tables in the filesystem. The default -is 2. Currently the Linux MS\-DOS filesystem does not support more than 2 -FATs. -.IP "\fB\-F\fP \fIFAT\-size\fP" 4 -Specifies the type of file allocation tables used (12, 16 or 32 bit). If +.IP "\fB\-f\fP \fINUMBER\-OF\-FATS\fP" 4 +Specify the number of file allocation tables in the filesystem. The default +is 2. +.IP "\fB\-F\fP \fIFAT\-SIZE\fP" 4 +Specifies the type of file allocation tables used (12, 16 or 32 bit). If nothing is specified, \fBmkfs.fat\fP will automatically select between 12, 16 and 32 bit, whatever fits better for the filesystem size. -.IP "\fB\-h\fP \fInumber\-of\-hidden\-sectors\fP" 4 -Select the number of hidden sectors in the volume. Apparently some digital +.IP "\fB\-h\fP \fINUMBER\-OF\-HIDDEN\-SECTORS\fP" 4 +Select the number of hidden sectors in the volume. Apparently some digital cameras get indigestion if you feed them a CF card without such hidden sectors, this option allows you to satisfy them. -.IP "\fB\-i\fP \fIvolume\-id\fP" 4 -Sets the volume ID of the newly created filesystem; \fIvolume\-id\fP is a 32\-bit -hexadecimal number (for example, 2e24ec82). The default is a number which +.IP "\fB\-i\fP \fIVOLUME\-ID\fP" 4 +Sets the volume ID of the newly created filesystem; \fIVOLUME\-ID\fP is a 32\-bit +hexadecimal number (for example, 2e24ec82). The default is a number which depends on the filesystem creation time. .IP \fB\-I\fP 4 It is typical for fixed disk devices to be partitioned so, by default, you -are not permitted to create a filesystem across the entire -device. \fBmkfs.fat\fP will complain and tell you that it refuses to work. This -is different when using MO disks. One doesn't always need partitions on MO -disks. The filesystem can go directly to the whole disk. Under other OSes -this is known as the 'superfloppy' format. This switch will force +are not permitted to create a filesystem across the entire device. +\fBmkfs.fat\fP will complain and tell you that it refuses to work. This is +different when using MO disks. One doesn't always need partitions on MO +disks. The filesystem can go directly to the whole disk. Under other OSes +this is known as the 'superfloppy' format. This switch will force \fBmkfs.fat\fP to work properly. -.IP "\fB\-l\fP \fIfilename\fP" 4 -Read the bad blocks list from \fIfilename\fP. -.IP "\fB\-m\fP \fImessage\-file\fP" 4 +.IP "\fB\-l\fP \fIFILENAME\fP" 4 +Read the bad blocks list from \fIFILENAME\fP. +.IP "\fB\-m\fP \fIMESSAGE\-FILE\fP" 4 Sets the message the user receives on attempts to boot this filesystem -without having properly installed an operating system. The message file must -not exceed 418 bytes once line feeds have been converted to carriage -return\-line feed combinations, and tabs have been expanded. If the filename +without having properly installed an operating system. The message file +must not exceed 418 bytes once line feeds have been converted to carriage +return\-line feed combinations, and tabs have been expanded. If the filename is a hyphen (\-), the text is taken from standard input. -.IP "\fB\-M\fP \fIFAT\-media\-type\fP" 4 -Specify the media type to be stored in the FAT boot sector. This value is -usually 0xF8 for hard disks and has a value from 0xF9 to 0xFF for floppies -or partitions to be used for floppy emulation. -.IP "\fB\-n\fP \fIvolume\-name\fP" 4 -Sets the volume name (label) of the filesystem. The volume name can be up to -11 characters long. The default is no label. -.IP "\fB\-r\fP \fIroot\-dir\-entries\fP" 4 -Select the number of entries available in the root directory. The default is -112 or 224 for floppies and 512 for hard disks. -.IP "\fB\-R\fP \fInumber\-of\-reserved\-sectors\fP" 4 -Select the number of reserved sectors. With FAT32 format at least 2 reserved -sectors are needed, the default is 32. Otherwise the default is 1 (only the -boot sector). -.IP "\fB\-s\fP \fIsectors\-per\-cluster\fP" 4 -Specify the number of disk sectors per cluster. Must be a power of 2, +.IP "\fB\-M\fP \fIFAT\-MEDIA\-TYPE\fP" 4 +Specify the media type to be stored in the FAT boot sector. This value is +usually 0xF8 for hard disks and is 0xF0 or a value from 0xF9 to 0xFF for +floppies or partitions to be used for floppy emulation. +.IP "\fB\-n\fP \fIVOLUME\-NAME\fP" 4 +Sets the volume name (label) of the filesystem. The volume name can be up +to 11 characters long. The default is no label. +.IP "\fB\-r\fP \fIROOT\-DIR\-ENTRIES\fP" 4 +Select the number of entries available in the root directory. The default +is 112 or 224 for floppies and 512 for hard disks. +.IP "\fB\-R\fP \fINUMBER\-OF\-RESERVED\-SECTORS\fP" 4 +Select the number of reserved sectors. With FAT32 format at least 2 +reserved sectors are needed, the default is 32. Otherwise the default is 1 +(only the boot sector). +.IP "\fB\-s\fP \fISECTORS\-PER\-CLUSTER\fP" 4 +Specify the number of disk sectors per cluster. Must be a power of 2, i.e. 1, 2, 4, 8, ... 128. -.IP "\fB\-S\fP \fIlogical\-sector\-size\fP" 4 -Specify the number of bytes per logical sector. Must be a power of 2 and +.IP "\fB\-S\fP \fILOGICAL\-SECTOR\-SIZE\fP" 4 +Specify the number of bytes per logical sector. Must be a power of 2 and greater than or equal to 512, i.e. 512, 1024, 2048, 4096, 8192, 16384, or 32768. .IP \fB\-v\fP 4 Verbose execution. - +.IP \fB\-\-invariant\fP 4 +Use constants for normally randomly generated or time based data such as +volume ID and creation time. Multiple runs of \fBmkfs.fat\fP on the same +device create identical results with this option. Its main purpose is +testing \fBmkfs.fat\fP. +.IP \fB\-\-help\fP 4 +.\" ---------------------------------------------------------------------------- +Display option summary and exit. .SH BUGS -\fBmkfs.fat\fP can not create boot\-able filesystems. This isn't as easy as you +.\" ---------------------------------------------------------------------------- +\fBmkfs.fat\fP can not create boot\-able filesystems. This isn't as easy as you might think at first glance for various reasons and has been discussed a lot -already. \fBmkfs.fat\fP simply will not support it ;) - +already. \fBmkfs.fat\fP simply will not support it ;) .SH "SEE ALSO" \fBfatlabel\fP(8) .br +.\" ---------------------------------------------------------------------------- \fBfsck.fat\fP(8) - .SH HOMEPAGE -More information about \fBfsck.fat\fP and \fBdosfstools\fP can be found at -<\fIhttp://daniel\-baumann.ch/software/dosfstools/\fP>. - +.\" ---------------------------------------------------------------------------- +The home for the \fBdosfstools\fP project is its +.UR https://github.com/dosfstools/dosfstools +GitHub project page +.UE . .SH AUTHORS -\fBdosfstools\fP were written by Werner Almesberger -<\fIwerner.almesberger@lrc.di.epfl.ch\fP>, Roman Hodek -<\fIRoman.Hodek@informatik.uni\-erlangen.de\fP>, and others. The current -maintainer is Daniel Baumann <\fImail@daniel\-baumann.ch\fP>. +\fBdosfstools\fP were written by +.MT werner.almesberger@\:lrc.di.epfl.ch +Werner Almesberger +.ME , +.MT Roman.Hodek@\:informatik.\:uni-erlangen.de +Roman Hodek +.ME , +and others. The current maintainer is +.MT aeb@\:debian.org +Andreas Bombe +.ME . diff --git a/manpages/en/fatlabel.8 b/manpages/en/fatlabel.8 index 6b50665..c00a795 100644 --- a/manpages/en/fatlabel.8 +++ b/manpages/en/fatlabel.8 @@ -19,32 +19,47 @@ .\" can be found in /usr/share/common-licenses/GPL-3 file. .\" .\" -.TH FATLABEL 8 2014\-11\-12 3.0.27 "dosfstools" - +.TH FATLABEL 8 2015\-05\-16 3.0.28 "dosfstools" .SH NAME \fBfatlabel\fR \- set or get MS\-DOS filesystem label - +.\" ---------------------------------------------------------------------------- .SH SYNOPSIS \fBfatlabel\fR \fIDEVICE\fR [\fILABEL\fR] - +.\" ---------------------------------------------------------------------------- .SH DESCRIPTION \fBfatlabel\fR set or gets a MS\-DOS filesystem label from a given device. .PP -If the label is omitted, then the label name of the specified device is written on the standard output. A label can't be longer than 11 bytes. - +If \fILABEL\fR is omitted, then the label name of the specified device is +written on the standard output. +A label can't be longer than 11 bytes. +.\" ---------------------------------------------------------------------------- .SH OPTIONS .IP "\fB\-h\fR, \fB\-\-help\fR" 4 Displays a help message. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 Shows version. - +.\" ---------------------------------------------------------------------------- .SH SEE ALSO \fBfsck.fat\fR(8) .br \fBmkfs.fat\fR(8) - +.\" ---------------------------------------------------------------------------- .SH HOMEPAGE -More information about \fBfatlabel\fR and \fBdosfstools\fR can be found at <\fIhttp://daniel\-baumann.ch/software/dosfstools/\fR>. - +The home for the \fBdosfstools\fR project is its +.UR https://github.com/dosfstools/dosfstools +GitHub project page +.UE . +.\" ---------------------------------------------------------------------------- .SH AUTHORS -\fBdosfstools\fR were written by Werner Almesberger <\fIwerner.almesberger@lrc.di.epfl.ch\fR>, Roman Hodek <\fIRoman.Hodek@informatik.uni-erlangen.de\fR>, and others. The current maintainer is Daniel Baumann <\fImail@daniel-baumann.ch\fR>. +\fBdosfstools\fR were written by +.MT werner.almesberger@\:lrc.di.epfl.ch +Werner Almesberger +.ME , +.MT Roman.Hodek@\:informatik.\:uni-erlangen.de +Roman Hodek +.ME , +and others. +The current maintainer is +.MT aeb@\:debian.org +Andreas Bombe +.ME . diff --git a/manpages/en/fsck.fat.8 b/manpages/en/fsck.fat.8 index 3d95dc8..f2d44d0 100644 --- a/manpages/en/fsck.fat.8 +++ b/manpages/en/fsck.fat.8 @@ -19,119 +19,188 @@ .\" can be found in /usr/share/common-licenses/GPL-3 file. .\" .\" -.TH FSCK.FAT 8 2014\-11\-12 3.0.27 "dosfstools" - +.TH FSCK.FAT 8 2015\-05\-16 3.0.28 "dosfstools" .SH NAME \fBfsck.fat\fR \- check and repair MS\-DOS filesystems - +.\" ---------------------------------------------------------------------------- .SH SYNOPSIS -\fBfsck.fat\fR|\fBfsck.msdos\fR|\fBfsck.vfat\fR [\-aAflnprtvVwy] [\-d \fIPATH\fR \-d\ \fI...\fR] [\-u\ \fIPATH\fR \-u \fI...\fR] \fIDEVICE\fR - +\fBfsck.fat\fR [\fIOPTIONS\fR] \fIDEVICE\fR +.\" ---------------------------------------------------------------------------- .SH DESCRIPTION -\fBfsck.fat\fR verifies the consistency of MS\-DOS filesystems and optionally tries to repair them. +\fBfsck.fat\fR verifies the consistency of MS\-DOS filesystems and optionally +tries to repair them. .PP The following filesystem problems can be corrected (in this order): .IP "*" 4 -FAT contains invalid cluster numbers. Cluster is changed to EOF. +FAT contains invalid cluster numbers. +Cluster is changed to EOF. .IP "*" 4 -File's cluster chain contains a loop. The loop is broken. +File's cluster chain contains a loop. +The loop is broken. .IP "*" 4 -Bad clusters (read errors). The clusters are marked bad and they are removed from files owning them. This check is optional. +Bad clusters (read errors). +The clusters are marked bad and they are removed from files owning them. +This check is optional. .IP "*" 4 -Directories with a large number of bad entries (probably corrupt). The directory can be deleted. +Directories with a large number of bad entries (probably corrupt). +The directory can be deleted. .IP "*" 4 -Files . and .. are non\-directories. They can be deleted or renamed. +Files . and .. are non\-directories. +They can be deleted or renamed. .IP "*" 4 -Directories . and .. in root directory. They are deleted. +Directories . and .. in root directory. +They are deleted. .IP "*" 4 -Bad filenames. They can be renamed. +Bad filenames. +They can be renamed. .IP "*" 4 -Duplicate directory entries. They can be deleted or renamed. +Duplicate directory entries. +They can be deleted or renamed. .IP "*" 4 -Directories with non\-zero size field. Size is set to zero. +Directories with non\-zero size field. +Size is set to zero. .IP "*" 4 -Directory . does not point to parent directory. The start pointer is adjusted. +Directory . does not point to parent directory. +The start pointer is adjusted. .IP "*" 4 -Directory .. does not point to parent of parent directory. The start pointer is adjusted. +Directory .. does not point to parent of parent directory. +The start pointer is adjusted. .IP "*" 4 -Start cluster number of a file is invalid. The file is truncated. +Start cluster number of a file is invalid. +The file is truncated. .IP "*" 4 -File contains bad or free clusters. The file is truncated. +File contains bad or free clusters. +The file is truncated. .IP "*" 4 -File's cluster chain is longer than indicated by the size fields. The file is truncated. +File's cluster chain is longer than indicated by the size fields. +The file is truncated. .IP "*" 4 -Two or more files share the same cluster(s). All but one of the files are truncated. If the file being truncated is a directory file that has already been read, the filesystem check is restarted after truncation. +Two or more files share the same cluster(s). +All but one of the files are truncated. +If the file being truncated is a directory file that has already been read, the +filesystem check is restarted after truncation. .IP "*" 4 -File's cluster chain is shorter than indicated by the size fields. The file is truncated. +File's cluster chain is shorter than indicated by the size fields. +The file is truncated. .IP "*" 4 -Clusters are marked as used but are not owned by a file. They are marked as free. +Clusters are marked as used but are not owned by a file. +They are marked as free. .PP Additionally, the following problems are detected, but not repaired: .IP "*" 4 -Invalid parameters in boot sector. +Invalid parameters in boot sector .IP "*" 4 Absence of . and .. entries in non\-root directories .PP -When \fBfsck.fat\fR checks a filesystem, it accumulates all changes in memory and performs them only after all checks are complete. This can be disabled with the \fB\-w\fR option. - +When \fBfsck.fat\fR checks a filesystem, it accumulates all changes in memory +and performs them only after all checks are complete. +This can be disabled with the \fB\-w\fR option. +.\" ---------------------------------------------------------------------------- .SH OPTIONS .IP "\fB\-a\fR" 4 -Automatically repair the filesystem. No user intervention is necessary. Whenever there is more than one method to solve a problem, the least destructive approach is used. +Automatically repair the filesystem. +No user intervention is necessary. +Whenever there is more than one method to solve a problem, the least +destructive approach is used. .IP "\fB\-A\fR" 4 -Use Atari variation of the MS\-DOS filesystem. This is default if \fBfsck.fat\fR is run on an Atari, then this option turns off Atari format. There are some minor differences in Atari format: Some boot sector fields are interpreted slightly different, and the special FAT entries for end\-of\-file and bad cluster can be different. Under MS\-DOS 0xfff8 is used for EOF and Atari employs 0xffff by default, but both systems recognize all values from 0xfff8...0xffff as end\-of\-file. MS\-DOS uses only 0xfff7 for bad clusters, where on Atari values 0xfff0...0xfff7 are for this purpose (but the standard value is still 0xfff7). +Use Atari variation of the MS\-DOS filesystem. +This is default if \fBfsck.fat\fR is run on an Atari, then this option turns +off Atari format. +There are some minor differences in Atari format: +Some boot sector fields are interpreted slightly different, and the special FAT +entries for end\-of\-file and bad cluster can be different. +Under MS\-DOS 0xfff8 is used for EOF and Atari employs 0xffff by default, but +both systems recognize all values from 0xfff8...0xffff as end\-of\-file. +MS\-DOS uses only 0xfff7 for bad clusters, where on Atari values 0xfff0...0xfff7 +are for this purpose (but the standard value is still 0xfff7). .IP "\fB-b\fR" 4 Make read-only boot sector check. -.IP "\fB\-d\fR" 4 -Delete the specified file. If more that one file with that name exists, the first one is deleted. +.IP "\fB\-d\fR \fIPATH\fR" 4 +Delete the specified file. +If more than one file with that name exist, the first one is deleted. +This option can be given more than once. .IP "\fB\-f\fR" 4 -Salvage unused cluster chains to files. By default, unused clusters are added to the free disk space except in auto mode (\fB\-a\fR). +Salvage unused cluster chains to files. +By default, unused clusters are added to the free disk space except in auto mode +(\fB\-a\fR). .IP "\fB\-l\fR" 4 List path names of files being processed. .IP "\fB\-n\fR" 4 No\-operation mode: non\-interactively check for errors, but don't write anything to the filesystem. .IP "\fB\-p\fR" 4 -Same as (\fB\-a\fR), for compatibility with other *fsck. +Same as \fB\-a\fR, for compatibility with other *fsck. .IP "\fB\-r\fR" 4 -Interactively repair the filesystem. The user is asked for advice whenever -there is more than one approach to fix an inconsistency. +Interactively repair the filesystem. +The user is asked for advice whenever there is more than one approach to fix an +inconsistency. +This is the default mode and the option is only retained for backwards +compatibility. .IP "\fB\-t\fR" 4 Mark unreadable clusters as bad. -.IP "\fB\-u\fR" 4 -Try to undelete the specified file. \fBfsck.fat\fR tries to allocate a chain of contiguous unallocated clusters beginning with the start cluster of the undeleted file. +.IP "\fB\-u\fR \fIPATH\fR" 4 +Try to undelete the specified file. +\fBfsck.fat\fR tries to allocate a chain of contiguous unallocated clusters +beginning with the start cluster of the undeleted file. +This option can be given more than once. .IP "\fB\-v\fR" 4 -Verbose mode. Generates slightly more output. +Verbose mode. +Generates slightly more output. .IP "\fB\-V\fR" 4 -Perform a verification pass. The filesystem check is repeated after the first run. The second pass should never report any fixable errors. It may take considerably longer than the first pass, because the first pass may have generated long list of modifications that have to be scanned for each disk read. +Perform a verification pass. +The filesystem check is repeated after the first run. +The second pass should never report any fixable errors. +It may take considerably longer than the first pass, because the first pass may +have generated long list of modifications that have to be scanned for each disk +read. .IP "\fB\-w\fR" 4 Write changes to disk immediately. .IP "\fB\-y\fR" 4 -Same as \fB\-a\fR (automatically repair filesystem) for compatibility with other fsck tools. -.PP -\fBNote:\fR If \fB\-a\fR and \fB\-r\fR are absent, the filesystem is only checked, but not repaired. - +Same as \fB\-a\fR (automatically repair filesystem) for compatibility with other +fsck tools. +.\" ---------------------------------------------------------------------------- .SH "EXIT STATUS" .IP "0" 4 No recoverable errors have been detected. .IP "1" 4 -Recoverable errors have been detected or \fBfsck.fat\fR has discovered an internal inconsistency. +Recoverable errors have been detected or \fBfsck.fat\fR has discovered an +internal inconsistency. .IP "2" 4 -Usage error. \fBfsck.fat\fR did not access the filesystem. - +Usage error. +\fBfsck.fat\fR did not access the filesystem. +.\" ---------------------------------------------------------------------------- .SH FILES .IP "fsck0000.rec, fsck0001.rec, ..." 4 -When recovering from a corrupted filesystem, \fBfsck.fat\fR dumps recovered data into files named 'fsckNNNN.rec' in the top level directory of the filesystem. - +When recovering from a corrupted filesystem, \fBfsck.fat\fR dumps recovered data +into files named 'fsckNNNN.rec' in the top level directory of the filesystem. +.\" ---------------------------------------------------------------------------- .SH BUGS -Does not create . and .. files where necessary. Does not remove entirely empty directories. Should give more diagnostic messages. Undeleting files should use a more sophisticated algorithm. - +Does not create . and .. files where necessary. +Does not remove entirely empty directories. +Should give more diagnostic messages. +Undeleting files should use a more sophisticated algorithm. +.\" ---------------------------------------------------------------------------- .SH SEE ALSO \fBfatlabel\fR(8) .br \fBmkfs.fat\fR(8) - +.\" ---------------------------------------------------------------------------- .SH HOMEPAGE -More information about \fBfsck.fat\fR and \fBdosfstools\fR can be found at <\fIhttp://daniel\-baumann.ch/software/dosfstools/\fR>. - +The home for the \fBdosfstools\fR project is its +.UR https://github.com/dosfstools/dosfstools +GitHub project page +.UE . +.\" ---------------------------------------------------------------------------- .SH AUTHORS -\fBdosfstools\fR were written by Werner Almesberger <\fIwerner.almesberger@lrc.di.epfl.ch\fR>, Roman Hodek <\fIRoman.Hodek@informatik.uni-erlangen.de\fR>, and others. The current maintainer is Daniel Baumann <\fImail@daniel-baumann.ch\fR>. +\fBdosfstools\fR were written by +.MT werner.almesberger@\:lrc.di.epfl.ch +Werner Almesberger +.ME , +.MT Roman.Hodek@\:informatik.\:uni-erlangen.de +Roman Hodek +.ME , +and others. +The current maintainer is +.MT aeb@\:debian.org +Andreas Bombe +.ME . diff --git a/manpages/en/mkfs.fat.8 b/manpages/en/mkfs.fat.8 index 9dd8115..5a5086e 100644 --- a/manpages/en/mkfs.fat.8 +++ b/manpages/en/mkfs.fat.8 @@ -19,69 +19,160 @@ .\" can be found in /usr/share/common-licenses/GPL-3 file. .\" .\" -.TH MKFS.FAT 8 2014\-11\-12 3.0.27 "dosfstools" - +.TH MKFS.FAT 8 2015\-05\-16 3.0.28 "dosfstools" .SH NAME \fBmkfs.fat\fR \- create an MS-DOS filesystem under Linux - +.\" ---------------------------------------------------------------------------- .SH SYNOPSIS -\fBmkfs.fat\fR [\fB\-a\fR] [\fB\-A\fR] [\fB\-b\fR \fIsector-of-backup\fR] [\fB\-c\fR] [\fB\-l\fR \fIfilename\fR] [\fB\-C\fR] [\fB\-f\fR \fInumber-of-FATs\fR] [\fB\-F\fR \fIFAT-size] [\fB\-h\fR \fInumber-of-hidden-sectors\fR] [\fB\-i\fR \fIvolume-id\fR] [\fB\-I\fR] [\fB\-m\fR \fImessage-file\fR] [\fB\-n\fR \fIvolume-name\fR] [\fB\-r\fR \fIroot-dir-entries\fR] [\fB\-R\fR \fInumber-of-reserved-sectors\fR] [\fB\-s\fR \fIsectors-per-cluster\fR] [\fB\-S \fIlogical-sector-size\fR] [\fB\-D\fR \fIdrive-number\fR] [\fB\-M \fIFAT-media-type\fR] [\fB\-v\fR] \fIdevice\fR [\fIblock-count\fR] - +\fBmkfs.fat\fR [\fIOPTIONS\fR] \fIDEVICE\fR [\fIBLOCK-COUNT\fR] +.\" ---------------------------------------------------------------------------- .SH DESCRIPTION -\fBmkfs.fat\fR is used to create an MS-DOS filesystem under Linux on a device (usually a disk partition). \fIdevice\fR is the special file corresponding to the device (e.g /dev/sdXX). \fIblock-count\fR is the number of blocks on the device. If omitted, \fBmkfs.fat\fR automatically determines the filesystem size. - +\fBmkfs.fat\fR is used to create an MS-DOS filesystem under Linux on a device +(usually a disk partition). +\fIDEVICE\fR is the special file corresponding to the device (e.g. /dev/sdXX). +\fIBLOCK-COUNT\fR is the number of blocks on the device. +If omitted, \fBmkfs.fat\fR automatically determines the filesystem size. +.\" ---------------------------------------------------------------------------- .SH OPTIONS .IP "\fB\-a\fR" 4 -Normally, for any filesystem except very small ones, \fBmkfs.fat\fR will align all the data structures to cluster size, to make sure that as long as the partition is properly aligned, so will all the data structures in the filesystem. This option disables alignment; this may provide a handful of additional clusters of storage at the expense of a significant performance degradation on RAIDs, flash media or large-sector hard disks. +Normally, for any filesystem except very small ones, \fBmkfs.fat\fR will align +all the data structures to cluster size, to make sure that as long as the +partition is properly aligned, so will all the data structures in the +filesystem. +This option disables alignment; this may provide a handful of additional +clusters of storage at the expense of a significant performance degradation on +RAIDs, flash media or large-sector hard disks. .IP "\fB \-A\fR" 4 -Use Atari variation of the MS-DOS filesystem. This is default if \fBmkfs.fat\fR is run on an Atari, then this option turns off Atari format. There are some differences when using Atari format: If not directed otherwise by the user, \fBmkfs.fat\fR will always use 2 sectors per cluster, since GEMDOS doesn't like other values very much. It will also obey the maximum number of sectors GEMDOS can handle. Larger filesystems are managed by raising the logical sector size. Under Atari format, an Atari-compatible serial number for the filesystem is generated, and a 12 bit FAT is used only for filesystems that have one of the usual floppy sizes (720k, 1.2M, 1.44M, 2.88M), a 16 bit FAT otherwise. This can be overridden with the \fB\-F\fR option. Some PC-specific boot sector fields aren't written, and a boot message (option \fB\-m\fR) is ignored. -.IP "\fB\-b\fR \fIsector-of-backup\fR" 4 -Selects the location of the backup boot sector for FAT32. Default depends on number of reserved sectors, but usually is sector 6. The backup must be within the range of reserved sectors. +Use Atari variation of the MS-DOS filesystem. +This is default if \fBmkfs.fat\fR is run on an Atari, then this option turns off +Atari format. +There are some differences when using Atari format: +If not directed otherwise by the user, \fBmkfs.fat\fR will always use 2 sectors +per cluster, since GEMDOS doesn't like other values very much. +It will also obey the maximum number of sectors GEMDOS can handle. +Larger filesystems are managed by raising the logical sector size. +Under Atari format, an Atari-compatible serial number for the filesystem is +generated, and a 12 bit FAT is used only for filesystems that have one of the +usual floppy sizes (720k, 1.2M, 1.44M, 2.88M), a 16 bit FAT otherwise. +This can be overridden with the \fB\-F\fR option. +Some PC-specific boot sector fields aren't written, and a boot message (option +\fB\-m\fR) is ignored. +.IP "\fB\-b\fR \fISECTOR-OF-BACKUP\fR" 4 +Selects the location of the backup boot sector for FAT32. +Default depends on number of reserved sectors, but usually is sector 6. +The backup must be within the range of reserved sectors. .IP "\fB\-c" 4 Check the device for bad blocks before creating the filesystem. .IP "\fB\-C\fR" 4 -Create the file given as \fIdevice\fR on the command line, and write the to-be-created filesystem to it. This can be used to create the new filesystem in a file instead of on a real device, and to avoid using \fBdd\fR in advance to create a file of appropriate size. With this option, the \fIblock-count\fR must be given, because otherwise the intended size of the filesystem wouldn't be known. The file created is a sparse file, which actually only contains the meta-data areas (boot sector, FATs, and root directory). The data portions won't be stored on the disk, but the file nevertheless will have the correct size. The resulting file can be copied later to a floppy disk or other device, or mounted through a loop device. -.IP "\fB\-D\fR \fIdrive-number\fR" 4 -Specify the BIOS drive number to be stored in the FAT boot sector. This value is usually 0x80 for hard disks and 0x00 for floppy devices or partitions to be used for floppy emulation. -.IP "\fB\-f\fR \fInumber-of-FATs\fR" 4 -Specify the number of file allocation tables in the filesystem. The default is 2. Currently the Linux MS-DOS filesystem does not support more than 2 FATs. -.IP "\fB\-F\fR \fIFAT-size\fR" 4 -Specifies the type of file allocation tables used (12, 16 or 32 bit). If nothing is specified, \fBmkfs.fat\fR will automatically select between 12, 16 and 32 bit, whatever fits better for the filesystem size. -.IP "\fB\-h\fR \fInumber-of-hidden-sectors\fR" 4 -Select the number of hidden sectors in the volume. Apparently some digital cameras get indigestion if you feed them a CF card without such hidden sectors, this option allows you to satisfy them. -.IP "\fB\-i\fR \fIvolume-id\fR" 4 -Sets the volume ID of the newly created filesystem; \fIvolume-id\fR is a 32-bit hexadecimal number (for example, 2e24ec82). The default is a number which depends on the filesystem creation time. +Create the file given as \fIDEVICE\fR on the command line, and write the +to-be-created filesystem to it. +This can be used to create the new filesystem in a file instead of on a real +device, and to avoid using \fBdd\fR in advance to create a file of appropriate +size. +With this option, the \fIBLOCK-COUNT\fR must be given, because otherwise the +intended size of the filesystem wouldn't be known. +The file created is a sparse file, which actually only contains the meta-data +areas (boot sector, FATs, and root directory). +The data portions won't be stored on the disk, but the file nevertheless will +have the correct size. +The resulting file can be copied later to a floppy disk or other device, or +mounted through a loop device. +.IP "\fB\-D\fR \fIDRIVE-NUMBER\fR" 4 +Specify the BIOS drive number to be stored in the FAT boot sector. +This value is usually 0x80 for hard disks and 0x00 for floppy devices or +partitions to be used for floppy emulation. +.IP "\fB\-f\fR \fINUMBER-OF-FATS\fR" 4 +Specify the number of file allocation tables in the filesystem. +The default is 2. +.IP "\fB\-F\fR \fIFAT-SIZE\fR" 4 +Specifies the type of file allocation tables used (12, 16 or 32 bit). +If nothing is specified, \fBmkfs.fat\fR will automatically select between 12, 16 +and 32 bit, whatever fits better for the filesystem size. +.IP "\fB\-h\fR \fINUMBER-OF-HIDDEN-SECTORS\fR" 4 +Select the number of hidden sectors in the volume. +Apparently some digital cameras get indigestion if you feed them a CF card +without such hidden sectors, this option allows you to satisfy them. +.IP "\fB\-i\fR \fIVOLUME-ID\fR" 4 +Sets the volume ID of the newly created filesystem; \fIVOLUME-ID\fR is a 32-bit +hexadecimal number (for example, 2e24ec82). +The default is a number which depends on the filesystem creation time. .IP "\fB\-I\fR" 4 -It is typical for fixed disk devices to be partitioned so, by default, you are not permitted to create a filesystem across the entire device. \fBmkfs.fat\fR will complain and tell you that it refuses to work. This is different when using MO disks. One doesn't always need partitions on MO disks. The filesystem can go directly to the whole disk. Under other OSes this is known as the 'superfloppy' format. This switch will force \fBmkfs.fat\fR to work properly. -.IP "\fB\-l\fR \fIfilename\fR" 4 -Read the bad blocks list from \fIfilename\fR. -.IP "\fB\-m\fR \fImessage-file\fR" 4 -Sets the message the user receives on attempts to boot this filesystem without having properly installed an operating system. The message file must not exceed 418 bytes once line feeds have been converted to carriage return-line feed combinations, and tabs have been expanded. If the filename is a hyphen (-), the text is taken from standard input. -.IP "\fB\-M\fR \fIFAT-media-type\fR" 4 -Specify the media type to be stored in the FAT boot sector. This value is usually 0xF8 for hard disks and has a value from 0xF9 to 0xFF for floppies or partitions to be used for floppy emulation. -.IP "\fB\-n\fR \fIvolume-name\fR" 4 -Sets the volume name (label) of the filesystem. The volume name can be up to 11 characters long. The default is no label. -.IP "\fB\-r\fR \fIroot-dir-entries\fR" 4 -Select the number of entries available in the root directory. The default is 112 or 224 for floppies and 512 for hard disks. -.IP "\fB\-R\fR \fInumber-of-reserved-sectors\fR" 4 -Select the number of reserved sectors. With FAT32 format at least 2 reserved sectors are needed, the default is 32. Otherwise the default is 1 (only the boot sector). -.IP "\fB\-s\fR \fIsectors-per-cluster\fR" 4 -Specify the number of disk sectors per cluster. Must be a power of 2, i.e. 1, 2, 4, 8, ... 128. -.IP "\fB\-S\fR \fIlogical-sector-size\fR" 4 -Specify the number of bytes per logical sector. Must be a power of 2 and greater than or equal to 512, i.e. 512, 1024, 2048, 4096, 8192, 16384, or 32768. +It is typical for fixed disk devices to be partitioned so, by default, you are +not permitted to create a filesystem across the entire device. +\fBmkfs.fat\fR will complain and tell you that it refuses to work. +This is different when using MO disks. +One doesn't always need partitions on MO disks. +The filesystem can go directly to the whole disk. +Under other OSes this is known as the 'superfloppy' format. +This switch will force \fBmkfs.fat\fR to work properly. +.IP "\fB\-l\fR \fIFILENAME\fR" 4 +Read the bad blocks list from \fIFILENAME\fR. +.IP "\fB\-m\fR \fIMESSAGE-FILE\fR" 4 +Sets the message the user receives on attempts to boot this filesystem without +having properly installed an operating system. +The message file must not exceed 418 bytes once line feeds have been converted +to carriage return-line feed combinations, and tabs have been expanded. +If the filename is a hyphen (-), the text is taken from standard input. +.IP "\fB\-M\fR \fIFAT-MEDIA-TYPE\fR" 4 +Specify the media type to be stored in the FAT boot sector. +This value is usually 0xF8 for hard disks and is 0xF0 or a value from 0xF9 to +0xFF for floppies or partitions to be used for floppy emulation. +.IP "\fB\-n\fR \fIVOLUME-NAME\fR" 4 +Sets the volume name (label) of the filesystem. +The volume name can be up to 11 characters long. +The default is no label. +.IP "\fB\-r\fR \fIROOT-DIR-ENTRIES\fR" 4 +Select the number of entries available in the root directory. +The default is 112 or 224 for floppies and 512 for hard disks. +.IP "\fB\-R\fR \fINUMBER-OF-RESERVED-SECTORS\fR" 4 +Select the number of reserved sectors. +With FAT32 format at least 2 reserved sectors are needed, the default is 32. +Otherwise the default is 1 (only the boot sector). +.IP "\fB\-s\fR \fISECTORS-PER-CLUSTER\fR" 4 +Specify the number of disk sectors per cluster. +Must be a power of 2, i.e. 1, 2, 4, 8, ... 128. +.IP "\fB\-S\fR \fILOGICAL-SECTOR-SIZE\fR" 4 +Specify the number of bytes per logical sector. +Must be a power of 2 and greater than or equal to 512, i.e. 512, 1024, 2048, +4096, 8192, 16384, or 32768. .IP "\fB\-v\fR" 4 Verbose execution. - +.IP "\fB\-\-invariant\fR" 4 +Use constants for normally randomly generated or time based data such as +volume ID and creation time. +Multiple runs of \fBmkfs.fat\fR on the same device create identical results +with this option. +Its main purpose is testing \fBmkfs.fat\fR. +.IP "\fB\-\-help\fR" 4 +Display option summary and exit. +.\" ---------------------------------------------------------------------------- .SH BUGS -\fBmkfs.fat\fR can not create boot-able filesystems. This isn't as easy as you might think at first glance for various reasons and has been discussed a lot already. \fBmkfs.fat\fR simply will not support it ;) - +\fBmkfs.fat\fR can not create boot-able filesystems. +This isn't as easy as you might think at first glance for various reasons and +has been discussed a lot already. +\fBmkfs.fat\fR simply will not support it ;) +.\" ---------------------------------------------------------------------------- .SH SEE ALSO \fBfatlabel\fR(8) .br \fBfsck.fat\fR(8) - +.\" ---------------------------------------------------------------------------- .SH HOMEPAGE -More information about \fBfsck.fat\fR and \fBdosfstools\fR can be found at <\fIhttp://daniel\-baumann.ch/software/dosfstools/\fR>. - +The home for the \fBdosfstools\fR project is its +.UR https://github.com/dosfstools/dosfstools +GitHub project page +.UE . +.\" ---------------------------------------------------------------------------- .SH AUTHORS -\fBdosfstools\fR were written by Werner Almesberger <\fIwerner.almesberger@lrc.di.epfl.ch\fR>, Roman Hodek <\fIRoman.Hodek@informatik.uni-erlangen.de\fR>, and others. The current maintainer is Daniel Baumann <\fImail@daniel-baumann.ch\fR>. +\fBdosfstools\fR were written by +.MT werner.almesberger@\:lrc.di.epfl.ch +Werner Almesberger +.ME , +.MT Roman.Hodek@\:informatik.\:uni-erlangen.de +Roman Hodek +.ME , +and others. +The current maintainer is +.MT aeb@\:debian.org +Andreas Bombe +.ME . diff --git a/manpages/po/de/fatlabel.8.po b/manpages/po/de/fatlabel.8.po index 27c69f5..a2b6da2 100644 --- a/manpages/po/de/fatlabel.8.po +++ b/manpages/po/de/fatlabel.8.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: dosfstools VERSION\n" -"POT-Creation-Date: 2014-11-12 00:52+0100\n" +"POT-Creation-Date: 2015-05-16 00:40+0200\n" "PO-Revision-Date: 2013-06-06 09:34+0300\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -22,13 +22,13 @@ msgstr "" #. type: TH #: en/fatlabel.8:22 en/fsck.fat.8:22 en/mkfs.fat.8:22 #, no-wrap -msgid "2014-11-12" +msgid "2015-05-16" msgstr "" #. type: TH #: en/fatlabel.8:22 en/fsck.fat.8:22 en/mkfs.fat.8:22 #, no-wrap -msgid "3.0.27" +msgid "3.0.28" msgstr "" #. type: TH @@ -38,113 +38,136 @@ msgid "dosfstools" msgstr "" #. type: SH -#: en/fatlabel.8:24 en/fsck.fat.8:24 en/mkfs.fat.8:24 +#: en/fatlabel.8:23 en/fsck.fat.8:23 en/mkfs.fat.8:23 #, no-wrap msgid "NAME" msgstr "" +#. ---------------------------------------------------------------------------- #. type: Plain text #: en/fatlabel.8:26 msgid "B - set or get MS-DOS filesystem label" msgstr "" #. type: SH -#: en/fatlabel.8:27 en/fsck.fat.8:27 en/mkfs.fat.8:27 +#: en/fatlabel.8:26 en/fsck.fat.8:26 en/mkfs.fat.8:26 #, no-wrap msgid "SYNOPSIS" msgstr "" +#. ---------------------------------------------------------------------------- #. type: Plain text #: en/fatlabel.8:29 msgid "B I [I