mkfdmn man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=mkfdmn&af=0&tf=2&of=DigitalUNIX

mkfdmn(8)							     mkfdmn(8)

NAME
       mkfdmn - Creates a new AdvFS domain

SYNOPSIS
       /sbin/mkfdmn   [-F]   [-l  num_pages]  [-o]  [-p	 num_pages]  [-r]  [-x
       num_pages] [-V3	| -V4] special domain

OPTIONS
       Ignores overlapping partition or block warnings.	 Sets  the  number  of
       pages  in  the  log file.  AdvFS rounds this number up to a multiple of
       four.  Allows reuse of an existing domain name. It destroys the	exist‐
       ing  domain  and	 creates  a  new domain with the existing domain name.
       Sets the number of pages to preallocate for the bitfile metadata	 table
       (BMT).  The default is 0 (zero) pages. This option may be useful if you
       have chosen the -V3 option; it is not applicable	 for  domains  created
       with  V4.  Specifies the domain as the local root domain. This prevents
       multiple volumes in the root domain.  AdvFS supports only one volume in
       the  local root domain. This does not apply to the cluster root domain.
       If you specify -V3, creates an AdvFS domain that uses the on-disk  for‐
       mats employed by AdvFS prior to the release of OS Version 5.0; that is,
       creates a domain with a domain version number (DVN) of 3.  If you spec‐
       ify -V4, creates an AdvFS domain that uses the on-disk formats employed
       by AdvFS starting with the release of OS Version 5.0; that is,  creates
       a  domain with a DVN of 4.  If neither option is specified, the default
       action is to use the DVN 4 on-disk formats for the  domain.   Sets  the
       number  of  pages by which the BMT extent size grows. The value must be
       greater than or equal to 128 pages. The	default	 is  128  pages.  This
       option  may  be	useful	if  you	 have chosen the -V3 option; it is not
       applicable for domains created with the -V4 option

OPERANDS
       Specifies the block special device name, such  as  /dev/disk/dsk1c,  or
       the  LSM	 volume	 name of the initial volume that you use to create the
       domain.	This command supports  short  hand  names  for	block  special
       devices.	 For  example,	if  you	 enter dsk2g, it will be translated to
       /dev/disk/dsk2g.	 Specifies the name of the domain.

DESCRIPTION
       The mkfdmn command creates a domain, which is a logical construct  con‐
       taining	both physical volumes (disks or disk partitions) and filesets.
       When you create a domain, you must specify one volume. This can	be  an
       LSM volume.

       The  minimum  size  of  an AdvFS domain depends, to some degree, on the
       size of the disk or logical volume on which it is created. It is gener‐
       ally  not possible to create a domain smaller than 6 or 7 megabytes. If
       you attempt to create a domain on a disk or logical volume that is  too
       small, AdvFS will display errors like the following: bs_disk_init: disk
       is too small mkfdmn: domain init error  ENO_MORE_BLKS  (-1040)  mkfdmn:
       can't create new domain 'small_domain'

       If  you	try  to	 add a volume with partitions that overlap any volumes
       used by another file system (as indicated on the disk label), including
       UFS,  AdvFS,  and  LSM, the mkfdmn command displays a message asking if
       you want to continue: Partition(s) which overlap /dev/rdisk/dsk10a  are
       marked  in  use.	  If  you continue with the operation you can possibly
       destroy existing data.  CONTINUE? [y/n] y

       Use the -F option to disable testing for overlap.

       If you are creating a domain and requesting a partition	that  overlaps
       an  existing  /etc/fdmns	 entry, the mkfdmn command will not create the
       partition. If the partition is in use, you will receive a  message ask‐
       ing  if you want to override. If you want to override without a prompt,
       use the -F option.

				       Caution

       Existing data on the volume you assign to a  new	 domain	 is  destroyed
       when the domain is created.

       The  mkfdmn  command  does not create a file system that you can mount.
       In order to mount an AdvFS file system, the domain must contain one  or
       more  filesets.	Run  the mkfset command to create at least one fileset
       within the new domain. You can access the domain as soon as  you	 mount
       one or more filesets. For more information about creating filesets, see
       mkfset(8).

       To remove a domain, dismount all filesets in the	 domain	 you  want  to
       remove.	Then  use  the rmfdmn command to remove the domain.  Using the
       rmfdmn command is preferable  to	 removing  the	directory  defining  a
       domain  because the command changes the disk label information to indi‐
       cate that the partition is no longer in use by AdvFS.

       If the /etc/fdmns directory is lost or the  volumes  of	a  domain  are
       moved to a different system, you can use the advscan command to re-cre‐
       ate a domain. See advscan(8).

       Domains created with the -V3 option that contain a very large number of
       files  may  need	 added	BMT  mcells  (similar  to  inodes in UFS).  By
       default, AdvFS attempts to grow the BMT by 128 pages  each  time	 addi‐
       tional mcells are needed. This may cause the metadata storage to become
       very fragmented, resulting in a premature “out of disk space” error.

       You can reduce the  amount  of  BMT  metadata  fragmentation  for  file
       domains	created	 with the -V3 option either by preallocating space for
       the BMT or by increasing the number of pages that the  system  attempts
       to  grow the BMT each time space is needed. Use the -p option to preal‐
       locate all the BMT space you expect the file domain to need. Note  that
       space  that is preallocated cannot be deallocated. Use the -x option to
       specify how many pages the BMT should be extended each time  additional
       mcells are needed.

       The  following  table  provides guidelines for BMT growth size in pages
       (-x option) and BMT preallocation (-p option) that you may want to  use
       if you are creating domains with the -V3 option. If your estimated num‐
       ber of files is greater than those listed in the table,	keep  doubling
       the last table entry until you get a value that is close to your needs.

       ─────────────────────────────────────────────────────────────────────
       Number of Files	  BMT	Growth	 Size  in   BMT Preallocation  Size
			  Pages			    in Pages
       ─────────────────────────────────────────────────────────────────────
       Less than 50,000	  Default (128)		    3,600
       100,000		  256			    7,200
       200,000		  512			    14,400
       300,000		  768			    21,600
       400,000		  1024			    28,800
       800,000		  2048			    57,600
       ─────────────────────────────────────────────────────────────────────

NOTES
       If  you	have  domains created on systems prior to Version 5 or domains
       created with the V3 option of mkfdmn, use the -p or -x option  to  grow
       the BMT extent allocations.  You must use the same option with the same
       number of pages when you add a volume  to  the  file  domain  with  the
       addvol  command. See addvol(8) for information about adding a volume to
       a file domain.

       Use a value in the -x num_pages argument that maintains	the  following
       relationship  between  the BMT extent size (the number of pages for the
       -x parameter) and the log file size (the number of  pages  for  the  -l
       parameter):

       BMT extent size <= (log file size * 8184) / 4

       It  takes  about	 one minute to process 5000 BMT extent size pages with
       the -x option.  A process that initiates a BMT  extent  size  operation
       must  take  into account that very large values for -x will take a long
       time to complete.

       This command supports shorthand names for LSM volume names.  For	 exam‐
       ple, if you enter the following: # mkfdmn  testdg.vol1 dom1

       the  volume  name  will be translated to: # mkfdmn /dev/vol/testdg/vol1
       dom1

RESTRICTIONS
       You must be the root user to use this command.

       All white space characters (tab, line feed, space, and so on) and the /
       # : * ?	characters are invalid for domain names.

ERRORS
       Command execution continues after the following warnings are displayed:
       mkfdmn: Invalid value for -x mkfdmn: Setting to minimum value of 128

	      Explanation:

	      You have entered an invalid value for the	 -x  option.   mkfdmn:
	      Invalid value for -p mkfdmn: Setting to minimum value of 0.

	      Explanation:

	      You have entered an invalid value for the -p option.

EXAMPLES
       The  following example creates the accounts_dmn domain with the special
       device /dev/disk/dsk1c as the initial volume: # mkfdmn  /dev/disk/dsk1c
       accounts_dmn

       Until  you  create and mount a fileset for the accounts_dmn domain, you
       cannot access the file system.

FILES
       Contains	 domain names and devices.

SEE ALSO
       Commands:  addvol(8),  advscan(8),  mkfset(8),	mount(8),   rmfdmn(8),
       showfdmn(8)

       Files: fdmns(4)

								     mkfdmn(8)
[top]

List of man pages available for DigitalUNIX

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]
Tweet
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