createvol(8)

NAME
createvol - create a non-replicated volume

SYNOPSIS
createvol <volume-name> <server-name> <partition-name>

DESCRIPTION
createvol is used to create a Coda non-replicated volume on the specified partition (<partion-name>) and server (<server-name>). The volume number is assigned by the server automatically; the name is specified by the invoker (<volume-name>). createvol first checks in /vice/vol/AllVolumes to see if the volume-name already exists. If not, it uses the volutil create command to create the volume at the specified server. It then uses bldvldb.sh (8) to build the Volume Location Data Base (VLDB). The default access control list of the volume gives the group System:Anyuser read and lookup rights. The owner of the root directory, as well as a more reasonable access list, must be set later by a system administrator using the cfs(1) command.

EXAMPLE
To Create a volume for user "hbovik" on server "mahler":

createvol user.hbovik mahler /vicepa

NOTES
This command does not create the mount point to the volume within the file system hierarchy. This must be created by the cfs mkmount(1) command.

DIAGNOSTICS
This command must be issued at the System Control Machine (SCM). Also, it must be invoked with effective user id of root. This command does not check for return codes from the servers once the volutil command is made. The invoker must check by hand in the /vice/vol/VolumeList file on the server to see if the volume name exists at that server.

FILES

/vice/vol/AllVolumes
    used to find out if volume already exists

/vice/vol/VolumeList
    name of volume created is appended to it

SEE ALSO
cfs (1), bldvldb.sh (8), volutil (8)

AUTHOR
Puneet Kumar, 1990, created