From 8895c5fadac4396041a52dcab9b473dbd77475ba Mon Sep 17 00:00:00 2001 From: Thomas Nikolajsen Date: Tue, 30 Mar 2010 01:21:35 +0200 Subject: [PATCH] dump.8/dumpfs.8/fsck.8/newfs.8/restore.8/tunefs.8: Note UFS only --- sbin/dump/dump.8 | 3 ++- sbin/dumpfs/dumpfs.8 | 3 ++- sbin/fsck/fsck.8 | 3 ++- sbin/newfs/newfs.8 | 15 ++++++++------- sbin/restore/restore.8 | 3 ++- sbin/tunefs/tunefs.8 | 25 ++++++++++++++----------- sbin/tunefs/tunefs.c | 6 +++--- 7 files changed, 33 insertions(+), 25 deletions(-) diff --git a/sbin/dump/dump.8 b/sbin/dump/dump.8 index f09fe8c256..f3cc36c5e5 100644 --- a/sbin/dump/dump.8 +++ b/sbin/dump/dump.8 @@ -40,7 +40,7 @@ .Sh NAME .Nm dump , .Nm rdump -.Nd file system backup +.Nd UFS file system backup .Sh SYNOPSIS .Nm .Op Fl 0123456789acknSu @@ -425,6 +425,7 @@ Startup errors are indicated with an exit code of 1; abnormal termination is indicated with an exit code of 3. .Sh SEE ALSO .Xr chflags 1 , +.Xr UFS 5 , .Xr fstab 5 , .Xr restore 8 , .Xr rmt 8 diff --git a/sbin/dumpfs/dumpfs.8 b/sbin/dumpfs/dumpfs.8 index 220567d46d..e4d3773e35 100644 --- a/sbin/dumpfs/dumpfs.8 +++ b/sbin/dumpfs/dumpfs.8 @@ -38,7 +38,7 @@ .Os .Sh NAME .Nm dumpfs -.Nd dump file system information +.Nd dump UFS file system information .Sh SYNOPSIS .Nm .Op Fl m @@ -62,6 +62,7 @@ is specified, a command is printed that can be used to generate a new file system with equivalent settings. .Sh SEE ALSO +.Xr UFS 5 , .Xr disktab 5 , .Xr fs 5 , .Xr disklabel 8 , diff --git a/sbin/fsck/fsck.8 b/sbin/fsck/fsck.8 index 2dc5535baf..63466bba74 100644 --- a/sbin/fsck/fsck.8 +++ b/sbin/fsck/fsck.8 @@ -39,7 +39,7 @@ .Os .Sh NAME .Nm fsck -.Nd filesystem consistency check and interactive repair +.Nd UFS filesystem consistency check and interactive repair .Sh SYNOPSIS .Nm .Fl p @@ -330,6 +330,7 @@ are fully enumerated and explained in Appendix A of .%T "Fsck \- The UNIX File System Check Program" .Re .Sh SEE ALSO +.Xr UFS 5 , .Xr fs 5 , .Xr fstab 5 , .Xr fsdb 8 , diff --git a/sbin/newfs/newfs.8 b/sbin/newfs/newfs.8 index 7a3a346893..9d26273076 100644 --- a/sbin/newfs/newfs.8 +++ b/sbin/newfs/newfs.8 @@ -39,7 +39,7 @@ .Sh NAME .Nm newfs , .Nm mount_mfs -.Nd construct a new file system +.Nd construct a new UFS file system .Sh SYNOPSIS .Nm .Op Fl NCOU @@ -248,15 +248,15 @@ Nowadays this value should be set to 1 (which essentially disables the rotational position table) because modern drives with read-ahead and write-behind do better without the rotational position table. .It Fl o Ar optimization\ preference -.Pq Ar space No or Ar time . +.Pq Cm space No or Cm time . The file system can either be instructed to try to minimize the time spent allocating blocks, or to try to minimize the space fragmentation on the disk. If the value of minfree (see above) is less than 8%, the default is to optimize for -.Ar space ; +.Cm space ; if the value of minfree is greater than or equal to 8%, the default is to optimize for -.Ar time . +.Cm time . See .Xr tunefs 8 for more details on how to set this option. @@ -390,12 +390,13 @@ Mount a 64 MB large memory file system on with .Xr mount 8 options -.Ar nosuid , -.Ar nodev , +.Cm nosuid , +.Cm nodev , and -.Ar nosymfollow . +.Cm nosymfollow . .Sh SEE ALSO .Xr fdformat 1 , +.Xr UFS 5 , .Xr disktab 5 , .Xr fs 5 , .Xr camcontrol 8 , diff --git a/sbin/restore/restore.8 b/sbin/restore/restore.8 index b6001f9f97..a62ed34391 100644 --- a/sbin/restore/restore.8 +++ b/sbin/restore/restore.8 @@ -39,7 +39,7 @@ .Sh NAME .Nm restore , .Nm rrestore -.Nd "restore files or file systems from backups made with dump" +.Nd "restore UFS file systems or files from backups made with dump" .Sh SYNOPSIS .Nm .Fl i @@ -446,6 +446,7 @@ may have to resynchronize itself. This message lists the number of blocks that were skipped over. .El .Sh SEE ALSO +.Xr UFS 5 , .Xr dump 8 , .Xr mount 8 , .Xr newfs 8 , diff --git a/sbin/tunefs/tunefs.8 b/sbin/tunefs/tunefs.8 index 4f700b0d9b..76c60191b2 100644 --- a/sbin/tunefs/tunefs.8 +++ b/sbin/tunefs/tunefs.8 @@ -38,22 +38,21 @@ .Os .Sh NAME .Nm tunefs -.Nd tune up an existing filesystem +.Nd tune up an existing UFS filesystem .Sh SYNOPSIS .Nm -.Op Fl A +.Op Fl \&Ap .Op Fl a Ar maxcontig .Op Fl d Ar rotdelay .Op Fl e Ar maxbpg .Op Fl f Ar avgfilesize .Op Fl m Ar minfree .Bk -words -.Op Fl n Ar enable | disable -.Op Fl o Ar space | time -.Op Fl p +.Op Fl n Cm enable | disable +.Op Fl o Cm space | time .Op Fl s Ar avgfpdir .Ek -.Op Ar special | Ar filesystem +.Brq Ar special | filesystem .Sh DESCRIPTION .Nm Tunefs is designed to change the dynamic parameters of a filesystem @@ -62,9 +61,11 @@ The parameters which are to be changed are indicated by the flags given below: .Bl -tag -width indent .It Fl A -The filesystem has several backups of the super-block. Specifying +The filesystem has several backups of the super-block. +Specifying this option will cause all backups to be modified as well as the -primary super-block. This is potentially dangerous - use with caution. +primary super-block. +This is potentially dangerous - use with caution. .It Fl a Ar maxcontig Specify the maximum number of contiguous blocks that will be laid out before forcing a rotational delay (see @@ -110,9 +111,9 @@ writes. Note that if the value is raised above the current usage level, users will be unable to allocate files until enough files have been deleted to get under the higher threshold. -.It Fl n Ar enable | disable +.It Fl n Cm enable | disable Turn on/off soft updates. -.It Fl o Ar space | time +.It Fl o Cm space | time The filesystem can either try to minimize the time spent allocating blocks, or it can attempt to minimize the space fragmentation on the disk. @@ -122,7 +123,8 @@ The kernel normally changes the preference automatically as the percent fragmentation changes on the filesystem. .It Fl p Show a summary of what the current tunable settings -are on the selected filesystem. More detailed information can be +are on the selected filesystem. +More detailed information can be obtained in the .Xr dumpfs 8 manual page. @@ -137,6 +139,7 @@ specified mount point. .El .Sh SEE ALSO .Xr fs 5 , +.Xr UFS 5 , .Xr dumpfs 8 , .Xr newfs 8 .Rs diff --git a/sbin/tunefs/tunefs.c b/sbin/tunefs/tunefs.c index ef63a9d606..6d7eb47ef3 100644 --- a/sbin/tunefs/tunefs.c +++ b/sbin/tunefs/tunefs.c @@ -293,9 +293,9 @@ void usage(void) { fprintf(stderr, "%s\n%s\n%s\n", -"usage: tunefs [-A] [-a maxcontig] [-d rotdelay] [-e maxbpg] [-f avgfilesize]", -" [-m minfree] [-p] [-n enable | disable] [-o space | time]", -" [-s filesperdir] [special | filesystem]"); +"usage: tunefs [-Ap] [-a maxcontig] [-d rotdelay] [-e maxbpg] [-f avgfilesize]", +" [-m minfree] [-n enable | disable] [-o space | time]", +" [-s filesperdir] {special | filesystem}"); exit(2); } -- 2.41.0