NAME

fsmake − Create a file system on a disk partition. 

SYNOPSIS

fsmake -dev device -part partition [options]

OPTIONS

−dev deviceDevice is the root name of a device, i.e. rxy0, rsd1, rsb0

−part partition
Partition is a letter indicating a partition, i.e. a, b, c, d, e, f, g. 

−devDir devDir
DevDir is an alternate directory in which to find the device file named by concatenating device and partition.  The default directory name is “/dev“. 

−initialPart firstPartName
firstPartName is the name of the initial partition on the disk which contains basic disk geometry information.  The default is partition “a”. 

−writeWrite the disk.  The default is to not write the disk. 

−overlapOverlap filesystem blocks across track boundaries. The default is to not overlap blocks. 

−ratioRatio of Kbytes to file descriptors. The default is 4. 

−testDon’t write to the disk. This is the default. 

−scsiCompute the disk geometry for a SCSI disk. The geometry will be laid out to maximize usable storage. 

−noscsiCompute the disk geometry for a non-SCSI disk. The geometry will be laid out to maximize transfer bandwidth.  The file system currently doesn’t do anything intelligent when laying out a file, so this option is probably not worth anything. 

−host hostIDSets the host id field in the domain header. The default is to use the local host id if the device server is the local host, otherwise use the device server’s id.  HostID is either the name or Sprite id of the machine to which the domain will be attached. 

−boot bootSectors
Number of sectors in the root partition to reserve for the boot program.

−repartitionThis option will change the partitioning of the disk.  DO NOT USE IF THE DISK CONTAINS A FILESYSTEM YOU WISH TO KEEP.  Use the −partdisktab option to use the partitioning information in the disktab file, otherwise use the −size option to set the size of the current partition. 

−partdisktabUse in conjunction with the −repartition option to set the disk partitioning from the disktab file. 

−size percentage
Use in conjunction with the −repartition option to specify the size of the current partition as a percentage of the total disk size. Percentage is an integer from 0-100. 

−reconfigReconfigures the basic disk geometry.  DO NOT USE IF THE DISK CONTAINS A FILESYSTEM YOU WISH TO KEEP.  If the disk is a non-scsi disk then you must also specify the −configdisktab option which causes the disk geometry to be read from the disktab file.  If the disk is a scsi disk then you may omit the −configdisktab option.  Fsmake will then invent a configuration that minimizes wasted disk space. 

−configdisktab
Use in conjunction with the −reconfig option to set the disk configuration (geometry) from the disktab file. 

−disktabName filename
Specify the disktab file.  The default is /etc/disktab. 

−disktype type
Specify the type of disk.  This type parameter must be the type of disk found in the disktab file.  This option must be present in order to use the disktab file. 

−labeltype type
Type of label to write on the disk.  The default is to write whatever label is appropriate for the machine on which fsmake is run. 

−dir directoryCopy the specified directory into the newly created filesystem. 
 

DESCRIPTION

Fsmake will create a Sprite filesystem on a partition.  It has a large number of options and is intended to be invoked from a shell script.  Fsmake’s basic function is to create a filesystem out of an entire partition by initializing the the file descriptor bitmap, data block bitmap and domain header, and creating the root and lost+found directories.  If you desire you can copy a directory tree into the new filesystem via the −dir option.  The −dir option is intended to be used under UNIX.  If you need to copy stuff into the new filesystem under Sprite use the update command.  The rest of the options are more complex and probably not used often.  The disk configuration, such as sectors per track, tracks per cylinder, etc, can be set using the −reconfig option.  Don’t use this option if the disk contains anything you want to keep, since it may goof up the size and location of the disk partition.  If you don’t specify the −configdisktab option then fsmake will make up a configuration that minimizes wasted disk space.  This only works under Sprite and on SCSI disks.  The −repartition allows you to change the partitioning of the disk.  The −partdisktab will set the partitioning from the disktab file.  Once again, don’t use this option if there is valuable stuff on the disk since you may lose it.  If you don’t use the −partdisktab option then you have to use the −size option to set the size of the current partition as a percentage of the total disk size.  Fsmake will adjust the start of all paritions that "follow" the current one on the disk.  Note that fsmake assumes an ordering on the partitions, ie disk and ’b’ is not used.  If you want to change the size of a bunch of partitions then run fsmake on the patritions in alphabetical order.  That should do the right thing.  The -ratio option allows you change the ratio of file system blocks to file descriptors.  Non-SCSI disks can have their file system blocks overlap track boundaries by specifying the -overlap option.  This packs more blocks per cylinder. 

Fsmake on UNIX

The fsmake command can be run on a UNIX system to create a Sprite filesystem.  There are several differences in functionality.  First, fsmake cannot make up a configuration for the disk.  The configuration must be set from the disktab file.  Second, the −dir option uses a special mechanism for creating Sprite devices.  If fsmake comes across a file with the suffix "SPRITE_DEV" it is assumed to be a placeholder for a Sprite device.  The contents of the file specify the device server, major number and minor number.  Lines that are blank or begin with ’#’ are ignored.  The file should contain one line with three integers -- the device server SpriteID, major number (device type), and minor number (device unit). 

KEYWORDS

filesystem
 

Sprite version 1.0  —  May 31, 1991