dfstab(4dfs)

Description
The dfstab file includes information about each DCE LFS aggregate and each non-LFS partition that can be exported from the local disk to the DCE namespace. The file is read by the dfsexport command, which exports specified aggregates and partitions to the DCE namespace. (It is also read by the newaggr command, which initializes DCE LFS aggregates.) The dfstab file must reside in the directory named dcelocal/var/dfs. The dfsexport command looks in that directory for the file; if the file is not there, no aggregates or partitions can be exported.

The dfstab file is an ASCII file that can be created and edited with a text editor. You must have write and execute permissions on the dcelocal/var/dfs directory to create the file. You must have write permission on the file to edit it.

The file contains a one-line entry for each aggregate or partition available for exporting. Each entry in the file must appear on its own line. The fields in the following list must appear for each entry; they must appear in the order listed, and each field must be separated by at least one space or tab. Because DCE LFS aggregates contain an arbitrary number of filesets, do not include a fileset ID number when creating an entry for a DCE LFS aggregate.

Device name
The block device name of the aggregate or partition to be exported; for example, /dev/lv02.

Aggregate name
The name to be associated with the aggregate or partition to be exported. An aggregate name can contain any characters, but it cannot be longer than 31 characters. It must be different from any other aggregate name in the dfstab file. Aggregate names cannot be abbreviated, so you should choose a short, descriptive name; for example, lfs1. The aggregate name of a non-LFS partition must match the name of the partition's local mount point (for example, /usr).

File system type
The identifier for the type of file system housing the aggregate or partition. For DCE LFS aggregates, this must be lfs; for non-LFS partitions, it must be ufs. Enter the identifier in all lowercase letters.

Aggregate ID
A positive integer different from any other aggregate ID in the dfstab file. In the entry for a non-LFS partition, this field must contain the aggregate ID number specified with the -aggrid option of the fts crfldbentry command.

Fileset ID
The unique fileset ID number to be associated with the fileset on a non-LFS partition; for example, 0,,18756. In the entry for a non-LFS partition, this field must contain the fileset ID number generated with the fts crfldbentry command. Do not include a fileset ID number with an entry for a DCE LFS aggregate.

When the dfsexport command is executed, it reads the dfstab file to verify that each aggregate or partition to be exported is listed in the file. An aggregate or partition must have an entry in the dfstab file if it is to be exported. To ensure that it does not export an aggregate or partition that is currently exported, the dfsexport command refers to a list of all currently exported aggregates and partitions that exists in the kernel of the local machine.

Cautions
Do not change the aggregate ID number assigned to an aggregate or partition in this file once Fileset Location Database (FLDB) entries have been created for filesets on the aggregate or partition. Changing the aggregate ID number used for an aggregate or partition in this file invalidates existing FLDB entries for filesets on the aggregate or partition.

Examples
The following dfstab file specifies that one non-LFS partition (/dev/lv02) and two DCE LFS aggregates (/dev/lv03 and /dev/lv04) can be exported:

/dev/lv02 /usr ufs 1 0,,18756

/dev/lv03 lfs1 lfs 3

/dev/lv04 lfs2 lfs 11

Related Information
Commands: dfsexport(8dfs)

fts crfldbentry(8dfs)