fmthard man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

FMTHARD(1M)							   FMTHARD(1M)

       fmthard - populate label on hard disks

       fmthard -d data | -n volume_name | -s datafile [-i] /dev/rdsk/c?
	    [t?] d?s2

       fmthard -d data | -n volume_name | -s datafile [-i] /dev/rdsk/c?
	    [t?] d?s2

       The fmthard command updates the VTOC (Volume Table of Contents) on hard
       disks and, on x86 systems, adds boot information to the	Solaris	 fdisk
       partition.  One or more of the options -s datafile, -d data, or -n vol‐
       ume_name must be used to request modifications to the  disk  label.  To
       print  disk  label  contents, see prtvtoc(1M). The /dev/rdsk/c?[t?]d?s2
       file must be the character special file of the  device  where  the  new
       label  is to be installed. On x86 systems, fdisk(1M) must be run on the
       drive before fmthard.

       If you are using an x86 system, note that  the  term  ``partition''  in
       this  page  refers  to  slices  within  the  x86 fdisk partition on x86
       machines. Do not confuse the partitions created	by  fmthard  with  the
       partitions created by fdisk.

       The following options are supported:

       -d data

	   The	data  argument	of  this  option  is a string representing the
	   information for a particular partition in  the  current  VTOC.  The
	   string must be of the format part:tag:flag:start:size where part is
	   the partition number, tag is the ID TAG of the partition,  flag  is
	   the set of permission flags, start is the starting sector number of
	   the partition, and size is the number of sectors in the  partition.
	   See	the  description of the datafile below for more information on
	   these fields.


	   This option allows the command to create the	 desired  VTOC	table,
	   but	prints the information to standard output instead of modifying
	   the VTOC on the disk.

       -n volume_name

	   This option is used to give the disk a volume_name up to 8  charac‐
	   ters long.

       -s datafile

	   This	 option	 is  used to populate the VTOC according to a datafile
	   created by the user. If the datafile is − (a hyphen), fmthard reads
	   from	 standard  input. The datafile format is described below. This
	   option causes all of the disk partition timestamp fields to be  set
	   to zero.

	   Every VTOC generated by fmthard will also have partition 2, by con‐
	   vention, that corresponds to	 the  whole  disk.  If	the  input  in
	   datafile  does not specify an entry for partition 2, a default par‐
	   tition 2 entry will be created automatically in VTOC with  the  tag
	   V_BACKUP and size equal to the full size of the disk.

	   The	datafile  contains  one specification line for each partition,
	   starting with partition 0. Each line is  delimited  by  a  new-line
	   character  (\n).   If  the first character of a line is an asterisk
	   (*), the line is treated as a comment. Each	line  is  composed  of
	   entries  that  are position-dependent, separated by white space and
	   having the following format:

	   partition tag flag starting_sector size_in_sectors

	   where the entries have the following values:


	       The partition number. Currently, for Solaris SPARC, a disk  can
	       have  up	 to 8 partitions, 0−7. Even though the partition field
	       has 4 bits, only 3 bits are currently used. For x86, all 4 bits
	       are used to allow slices 0−15. Each Solaris fdisk partition can
	       have up to 16 slices.


	       The partition tag: a decimal number. The following are reserved
	       codes:  0 (V_UNASSIGNED), 1 (V_BOOT), 2 (V_ROOT), 3 (V_SWAP), 4
	       (V_USR), 5 (V_BACKUP), 6 (V_STAND), 7 (V_VAR), and 8 (V_HOME).


	       The flag allows a partition to be  flagged  as  unmountable  or
	       read only, the masks being: V_UNMNT 0x01, and V_RONLY 0x10. For
	       mountable partitions use 0x00.


	       The sector number (decimal) on which the partition starts.


	       The number (decimal) of sectors occupied by the partition.

	   You can save the output of a prtvtoc command to a  file,  edit  the
	   file, and use it as the datafile argument to the -s option.

       uname(1), format(1M), prtvtoc(1M), attributes(5)

   x86 Only
       fdisk(1M), installgrub(1M)

       Special	care should be exercised when overwriting an existing VTOC, as
       incorrect entries could result in current data being inaccessible. As a
       precaution, save the old VTOC.

       For  disks under two terabytes, fmthard cannot write a VTOC on an unla‐
       beled disk. Use format(1M) for this purpose.

				 Sep 25, 2008			   FMTHARD(1M)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net