4833 Remove volrmmount
Reviewed by: Dan McDonald <danmcd@omniti.com>
Reviewed by: Josef 'Jeff' Sipek <jeffpc@josefsipek.net>

          --- old/usr/src/man/man1/fdformat.1
          +++ new/usr/src/man/man1/fdformat.1
   1    1  '\" te
   2    2  .\"  Copyright 2001, Sun Microsystems, Inc All Rights Reserved
        3 +.\"  Copyright 2014 Andrew Stormont.
   3    4  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    5  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    6  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH FDFORMAT 1 "Feb 28, 2007"
        7 +.TH FDFORMAT 1 "May 2, 2014"
   7    8  .SH NAME
   8    9  fdformat \- format floppy diskette or PCMCIA memory card
   9   10  .SH SYNOPSIS
  10   11  .LP
  11   12  .nf
  12   13  \fBfdformat\fR [\fB-dDeEfHlLmMUqvx\fR] [\fB-b\fR \fIlabel\fR] [\fB-B\fR \fIfilename\fR]
  13   14       [\fB-t\fR \fIdostype\fR] [\fIdevname\fR]
  14   15  .fi
  15   16  
  16   17  .SH DESCRIPTION

  17   18  .sp
  18   19  .LP
  19   20  The \fBfdformat\fR utility has been superseded by \fBrmformat\fR(1), which
  20   21  provides most but not all of \fBfdformat\fR's functionality.
  21   22  .sp
  22   23  .LP
  23   24  \fBfdformat\fR is used to format diskettes and \fBPCMCIA\fR memory cards. All
  24   25  new blank diskettes or \fBPCMCIA\fR memory cards must be formatted before they
  25   26  can be used.
  26   27  .sp
  27   28  .LP
  28   29  \fBfdformat\fR formats and verifies the media and indicates whether any bad
  29   30  sectors were encountered. All existing data on the diskette or \fBPCMCIA\fR
  30   31  memory card, if any, is destroyed by formatting. If no device name is given,
  31   32  \fBfdformat\fR uses the diskette as a default.
  32   33  .sp
  33   34  .LP
  34   35  By default, \fBfdformat\fR uses the configured capacity of the drive to format
  35   36  the diskette. A \fB3.5\fR inch high-density drive uses diskettes with a
  36   37  formatted capacity of \fB1.44MB\fR. A \fB5.25\fR inch high-density drive uses
  37   38  diskettes with a formatted capacity of \fB1.2MB\fR. In either case, a density
  38   39  option does not have to be specified to \fBfdformat\fR. However, a density
  39   40  option must be specified when using a diskette with a lower capacity than the
  40   41  drive's default. Use the \fB-H\fR option to format high-density diskettes
  41   42  (\fB1.44MB\fR capacity) in an extra-high-density (\fBED\fR) drive. Use the
  42   43  \fB-D\fR option, the \fB-l\fR option, or the \fB-L\fR option to format double-
  43   44  density (or low-density) diskettes (\fB720KB\fR capacity) in an \fBHD\fR or
  44   45  \fBED\fR drive. To format medium-density diskettes (\fB1.2MB\fR capacity), use
  45   46  the \fB-M\fR option with \fB-t\fR \fBnec\fR (this is the same as using the
  46   47  \fB-m\fR option with \fB-t\fR \fBnec\fR).
  47   48  .sp
  48   49  .LP
  49   50  Extended density uses double-sided, extended-density or extra-high-density
  50   51  (\fBDS\fR/\fBED\fR) diskettes. Medium and high densities use the same media:
  51   52  double-sided, high-density (\fBDS\fR/\fBHD\fR) diskettes. Double (low) density
  52   53  uses double-sided, double-density (\fBDS\fR/\fBDD\fR
  53   54  .sp
  54   55  .LP
  55   56  \fBD\fR) diskettes. Substituting diskettes of one density for diskettes of
  56   57  either a higher or lower density generally does not work. Data integrity cannot
  57   58  be assured whenever a diskette is formatted to a capacity not matching its
  58   59  density.
  59   60  .sp
  60   61  .LP
  61   62  A \fBPCMCIA\fR memory card with densities from \fB512KB\fR to \fB64MB\fR may be
  62   63  formatted.
  63   64  .sp
  64   65  .LP
  65   66  \fBfdformat\fR writes new identification and data fields for each sector on all
  66   67  tracks unless the \fB-x\fR option is specified. For diskettes, each sector is
  67   68  verified if the \fB-v\fR option is specified.
  68   69  .sp
  69   70  .LP
  70   71  After formatting and verifying, \fBfdformat\fR writes an operating-system label
  71   72  on block \fB0\fR. Use the \fB-t\fR \fBdos\fR option (same as the \fB-d\fR
  72   73  option) to put an \fBMS-DOS\fR file system on the diskette or \fBPCMCIA\fR
  73   74  memory card after the format is done. Use the \fB-t\fR \fBnec\fR option with
  74   75  the \fB-M\fR option (same as the \fB-m\fR option) to put an \fBNEC-DOS\fR file
  75   76  system on a diskette. Otherwise, \fBfdformat\fR writes a \fBSunOS\fR label in
  76   77  block \fB0\fR.
  77   78  .SH OPTIONS
  78   79  .sp
  79   80  .LP
  80   81  The following options are supported:
  81   82  .sp
  82   83  .ne 2
  83   84  .na
  84   85  \fB\fB-b\fR \fIlabel\fR\fR
  85   86  .ad
  86   87  .RS 15n
  87   88  Labels the media with volume label. A SunOS volume label is restricted to 8
  88   89  characters. A \fBDOS\fR volume label is restricted to 11 upper-case characters.
  89   90  .RE
  90   91  
  91   92  .sp
  92   93  .ne 2
  93   94  .na
  94   95  \fB\fB-B\fR \fIfilename\fR\fR
  95   96  .ad
  96   97  .RS 15n
  97   98  Installs special boot loader in filename on an \fBMS-DOS\fR diskette. This
  98   99  option is only meaningful when the \fB-d\fR option (or \fB-t\fR \fBdos\fR) is
  99  100  also specified.
 100  101  .RE
 101  102  
 102  103  .sp
 103  104  .ne 2
 104  105  .na
 105  106  \fB\fB-D\fR\fR
 106  107  .ad
 107  108  .RS 15n
 108  109  Formats a \fB720KB\fR (3.5 inch) or \fB360KB\fR (5.25 inch) double-density
 109  110  diskette (same as the \fB-l\fR or \fB-L\fR options). This is the default for
 110  111  double-density type drives. It is needed if the drive is a high- or
 111  112  extended-density type.
 112  113  .RE
 113  114  
 114  115  .sp
 115  116  .ne 2
 116  117  .na
 117  118  \fB\fB-e\fR\fR
 118  119  .ad
 119  120  .RS 15n
 120  121  Ejects the diskette when done. This feature is not available on all systems.
 121  122  .RE
 122  123  
 123  124  .sp
 124  125  .ne 2
 125  126  .na
 126  127  \fB\fB-E\fR\fR
 127  128  .ad
 128  129  .RS 15n
 129  130  Formats a \fB2.88MB\fR (3.5 inch) extended-density diskette. This is the
 130  131  default for extended-density type drives.
 131  132  .RE
 132  133  
 133  134  .sp
 134  135  .ne 2
 135  136  .na
 136  137  \fB\fB-f\fR\fR
 137  138  .ad
 138  139  .RS 15n
 139  140  Forces formatting, that is, this option does not ask for confirmation before
 140  141  starting format.
 141  142  .RE
 142  143  
 143  144  .sp
 144  145  .ne 2
 145  146  .na
 146  147  \fB\fB-H\fR\fR
 147  148  .ad
 148  149  .RS 15n
 149  150  Formats a \fB1.44MB\fR (3.5 inch) or \fB1.2MB\fR (5.25 inch) high-density
 150  151  diskette. This is the default for high-density type drives; it is needed if the
 151  152  drive is the extended-density type.
 152  153  .RE
 153  154  
 154  155  .sp
 155  156  .ne 2
 156  157  .na
 157  158  \fB\fB-M\fR\fR
 158  159  .ad
 159  160  .RS 15n
 160  161  Writes a \fB1.2MB\fR (3.5 inch) medium-density format on a high-density
 161  162  diskette (use only with the -t nec option). This is the same as using \fB-m\fR.
 162  163  .sp
 163  164  This feature is not available on all systems.
 164  165  .RE
 165  166  
 166  167  .sp
 167  168  .ne 2
 168  169  .na
 169  170  \fB\fB-q\fR\fR
 170  171  .ad
 171  172  .RS 15n
 172  173  Quiet; does not print status messages.
 173  174  .RE
 174  175  
 175  176  .sp
 176  177  .ne 2
 177  178  .na
 178  179  \fB\fB-t\fR \fBdos\fR\fR
 179  180  .ad
 180  181  .RS 15n
 181  182  Installs an \fBMS-DOS\fR file system and boot sector formatting. This is
 182  183  equivalent to the \fBDOS\fR format command or the \fB-d\fR option.
 183  184  .RE
 184  185  
 185  186  .sp
 186  187  .ne 2
 187  188  .na
 188  189  \fB\fB-t\fR \fBnec\fR\fR
 189  190  .ad
 190  191  .RS 15n
 191  192  Installs an \fBNEC-DOS\fR file system and boot sector on the disk after
 192  193  formatting. This should be used only with the \fB-M\fR option. This feature is
 193  194  not available on all systems.
 194  195  .RE
 195  196  
 196  197  .sp
 197  198  .ne 2
 198  199  .na
 199  200  \fB\fB-U\fR\fR
 200  201  .ad
 201  202  .RS 15n
 202  203  Performs \fBumount\fR on any file systems and then formats. See
 203  204  \fBmount\fR(1M).
 204  205  .RE
 205  206  
 206  207  .sp
 207  208  .ne 2
 208  209  .na
 209  210  \fB\fB-v\fR\fR
 210  211  .ad
 211  212  .RS 15n
 212  213  Verifies each block of the diskette after the format.
 213  214  .RE
 214  215  
 215  216  .sp
 216  217  .ne 2
 217  218  .na
 218  219  \fB\fB-x\fR\fR
 219  220  .ad
 220  221  .RS 15n
 221  222  Skips the format and only writes a SunOS label or an \fBMS-DOS\fR file system.
 222  223  .RE
 223  224  
 224  225  .SH OPERANDS
 225  226  .sp
 226  227  .LP
 227  228  The following operands are supported:
 228  229  .sp
 229  230  .ne 2
 230  231  .na
 231  232  \fB\fIdevname\fR\fR
 232  233  .ad
 233  234  .RS 11n
 234  235  Replaces \fIdevname\fR with \fBrdiskette0\fR (systems without volume
 235  236  management) or \fBfloppy0\fR (systems with volume management) to use the first
 236  237  drive or rdiskette1 (systems without volume management) or \fBfloppy1\fR
 237  238  (systems with volume management) to use the second drive. If \fIdevname\fR is
 238  239  omitted, the first drive, if one exists, is used. For \fBPCMCIA\fR memory
 239  240  cards, replace \fIdevname\fR with the device name for the \fBPCMCIA\fR memory
 240  241  card which resides in \fB/dev/rdsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR or
 241  242  /dev/dsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR. If \fIdevname\fR is omitted, the
 242  243  default diskette drive, if one exists, is used.
 243  244  .sp
 244  245  If devname is omitted, the default diskette drive, if one exists, will be used.
 245  246  \fIN\fR represents a decimal number and can be specified as follows:
 246  247  .sp
 247  248  .ne 2
 248  249  .na
 249  250  \fBc\fIN\fR\fR
 250  251  .ad
 251  252  .RS 6n
 252  253  Controller \fIN\fR
 253  254  .RE
 254  255  
 255  256  .sp
 256  257  .ne 2
 257  258  .na
 258  259  \fBt\fIN\fR\fR
 259  260  .ad
 260  261  .RS 6n
 261  262  Technology type \fIN\fR:
 262  263  .sp
 263  264  .in +2
 264  265  .nf
 265  266  
 266  267  0x1       ROM
 267  268  0x2       OTPROM
 268  269  0x3       EPROM
 269  270  0x4       EEPROM
 270  271  0x5       FLASH
 271  272  0x6       SRAM
 272  273  0x7       DRAM
 273  274  .fi
 274  275  .in -2
 275  276  .sp
 276  277  
 277  278  .RE
 278  279  
 279  280  .sp
 280  281  .ne 2
 281  282  .na
 282  283  \fBd\fIN\fR\fR
 283  284  .ad
 284  285  .RS 6n
 285  286  Technology region in type \fIN\fR.
 286  287  .RE
 287  288  
 288  289  .sp
 289  290  .ne 2
 290  291  .na
 291  292  \fBs\fIN\fR\fR
 292  293  .ad
 293  294  .RS 6n
 294  295  Slice \fIN\fR.
 295  296  .RE
 296  297  
 297  298  The following options are provided for compatibility with previous versions of
 298  299  \fBfdformat\fR. Their use is discouraged.
 299  300  .sp
 300  301  .ne 2
 301  302  .na
 302  303  \fB\fB-d\fR\fR
 303  304  .ad
 304  305  .RS 6n
 305  306  Formats an \fBMS-DOS\fR floppy diskette or \fBPCMCIA\fR memory card (same as
 306  307  \fB-t\fR \fBdos\fR). This is equivalent to the \fBMS-DOS FORMAT\fR command.
 307  308  .RE
 308  309  
 309  310  .sp
 310  311  .ne 2
 311  312  .na
 312  313  \fB\fB-l\fR\fR
 313  314  .ad
 314  315  .RS 6n
 315  316  Formats a \fB720KB\fR (3.5 inch) or \fB360KB\fR (5.25 inch) double-density
 316  317  diskette (same as \fB-D\fR or \fB-L\fR). This is the default for double-density
 317  318  type drives; it is needed if the drive is the high- or extended-density type.
 318  319  .RE
 319  320  
 320  321  .sp
 321  322  .ne 2
 322  323  .na
 323  324  \fB\fB-L\fR\fR
 324  325  .ad
 325  326  .RS 6n
 326  327  Formats a \fB720KB\fR (3.5 inch) or \fB360KB\fR (5.25 inch) double-density
 327  328  diskette (same as \fB-l\fR or \fB-D\fR). This is the default for double-density
 328  329  type drives.
 329  330  .RE
 330  331  
 331  332  .sp
 332  333  .ne 2
 333  334  .na
 334  335  \fB\fB-m\fR\fR
 335  336  .ad
 336  337  .RS 6n
 337  338  Writes a \fB1.2 MB\fR (3.5 inch) medium- density format on a high-density
 338  339  diskette (use only with the \fB-t\fR \fBnec\fR option). This is the same as
 339  340  using \fB-M\fR. This feature is not available on all systems.
 340  341  .RE
 341  342  
 342  343  .RE
 343  344  
 344  345  .SH FILES
 345  346  .sp
 346  347  .ne 2
 347  348  .na
 348  349  \fB/dev/diskette0\fR
 349  350  .ad
 350  351  .RS 24n
 351  352  Directory providing block device access for the media in floppy drive \fB0\fR.
 352  353  .RE
 353  354  
 354  355  .sp
 355  356  .ne 2
 356  357  .na
 357  358  \fB/dev/diskette0\fR
 358  359  .ad
 359  360  .RS 24n
 360  361  Directory providing character device access for the media in floppy drive
 361  362  \fB0\fR.
 362  363  .RE
 363  364  
 364  365  .sp
 365  366  .ne 2
 366  367  .na
 367  368  \fB/dev/aliases/floppy0\fR
 368  369  .ad
 369  370  .RS 24n
 370  371  Symbolic link to the character device for the media in floppy drive \fB0\fR.
 371  372  .RE
 372  373  
 373  374  .sp
 374  375  .ne 2
 375  376  .na
 376  377  \fB/dev/rdiskette\fR
 377  378  .ad
 378  379  .RS 24n
 379  380  Directory providing character device access for the media in the primary floppy
 380  381  drive, usually drive \fB0\fR.
 381  382  .RE
 382  383  
 383  384  .sp
 384  385  .ne 2
 385  386  .na
 386  387  \fB/dev/dsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR
 387  388  .ad
 388  389  .RS 24n
 389  390  Directory providing block device access for the \fBPCMCIA\fR memory card. See
 390  391  OPERANDS for a description of \fIN\fR.
 391  392  .RE
 392  393  
 393  394  .sp
 394  395  .ne 2
 395  396  .na
 396  397  \fB/dev/rdsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR
 397  398  .ad
 398  399  .RS 24n
 399  400  Directory providing character device access for the \fBPCMCIA\fR memory card.
 400  401  See OPERANDS for a description of \fIN\fR.
 401  402  .RE
 402  403  
 403  404  .sp
 404  405  .ne 2
 405  406  .na
 406  407  \fB/dev/aliases/pcmem\fIS\fR\fR
 407  408  .ad
 408  409  .RS 24n
 409  410  Symbolic link to the character device for the \fBPCMCIA\fR memory card in
 410  411  socket \fIS\fR where \fIS\fR represents a \fBPCMCIA\fR socket number.
 411  412  .RE
 412  413  
 413  414  .sp
 414  415  .ne 2
 415  416  .na
 416  417  \fB/dev/rdsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR
 417  418  .ad
 418  419  .RS 24n
 419  420  Directory providing character device access for the \fBPCMCIA\fR memory card.
 420  421  See OPERANDS for a description of \fIN\fR.
 421  422  .RE
 422  423  
 423  424  .sp
 424  425  .ne 2
 425  426  .na
 426  427  \fB/dev/dsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR

 427  428  .ad
 428  429  .RS 24n
 429  430  Directory providing block device access for the \fBPCMCIA\fR memory card. See
 430  431  OPERANDS for a description of \fIN\fR.
 431  432  .RE
 432  433  
 433  434  .SH SEE ALSO
 434  435  .sp
 435  436  .LP
 436  437  \fBcpio\fR(1), \fBeject\fR(1), \fBrmformat\fR(1), \fBtar\fR(1),
 437      -\fBvolcheck\fR(1), \fBvolrmmount\fR(1), \fBmount\fR(1M), \fBnewfs\fR(1M),
 438      -\fBprtvtoc\fR(1M), \fBattributes\fR(5), \fBpcfs\fR(7FS)
      438 +\fBvolcheck\fR(1), \fBmount\fR(1M), \fBnewfs\fR(1M), \fBprtvtoc\fR(1M),
      439 +\fBattributes\fR(5), \fBpcfs\fR(7FS)
 439  440  .SS "x86 Only"
 440  441  .sp
 441  442  .LP
 442  443  \fBfd\fR(7D)
 443  444  .SH NOTES
 444  445  .sp
 445  446  .LP
 446  447  A diskette or \fBPCMCIA\fR memory card containing a \fBufs\fR file system
 447  448  created on a SPARC based system (by using \fBfdformat\fR and \fBnewfs\fR(1M)),
 448  449  is not identical to a diskette or \fBPCMCIA\fR memory card containing a ufs

 449  450  file system created on an x86 based system. Do not interchange ufs diskettes or
 450  451  memory cards between these platforms. Use \fBcpio\fR(1) or \fBtar\fR(1) to
 451  452  transfer files on diskettes or memory cards between them. A diskette or
 452  453  \fBPCMCIA\fR memory card formatted using the \fB-t\fR \fBdos\fR option (or
 453  454  \fB-d\fR) for \fBMS-DOS\fR does not have the necessary system files, and is
 454  455  therefore not bootable. Trying to boot from it on a \fBPC\fR produces the
 455  456  following message:
 456  457  .sp
 457  458  .in +2
 458  459  .nf
 459  460  Non-System disk or disk error.
 460  461  Replace and strike any key when ready
 461  462  .fi
 462  463  .in -2
 463  464  .sp
 464  465  
 465  466  .SH BUGS
 466  467  .sp
 467  468  .LP
 468  469  Currently, bad sector mapping is not supported on floppy diskettes or
 469  470  \fBPCMCIA\fR memory cards. Therefore, a diskette or memory card is unusable if
 470  471  \fBfdformat\fR finds an error (bad sector).

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX