vrm - Remove a file or directory from the Vesta repository
vrm [-R repos] name
In the most common usage, only the name argument is given.
See the vesta-intro man page's Terminology section for definitions of terms, and its Name Interpretation section for an explanation of how names are looked up.
The vrm command removes a file or directory from the Vesta repository. Removing an object from an appendable directory leaves a ghost behind. If the object to be removed is a directory, it need not be empty.
This command provides an alternative to removing an object with the normal rm or rmdir commands through the repository's NFS interface. It is needed in cases where your NFS client thinks you don't have permission to remove because it doesn't fully understand Vesta access controls. The vrm command also makes it possible to remove an object from a remote repository that you do not have NFS mounted.
You must have write access to the directory from which name is to be removed.
vrm returns status 0 for success, 1 for parameter syntax errors, or 2 for more serious errors.
- -R repos
- Remove the object from repos instead of the default local repository. The repository is specified by host name and TCP port number in the format host:port. The :port portion may be omitted; it defaults to [Repository]VestaSourceSRPC_port.
The following values are obtained from the [UserInterface] section of the Vesta configuration file (vesta.cfg).
- AppendableRootName
- The filename under which the global root directory of Vesta repositories is mounted. Ordinarily set to /vesta.
- MutableRootName
- The filename under which the local tree of mutable directories provided by Vesta is mounted. Ordinarily set to /vesta-work.
- realm
- Global user names are formed by appending @realm to the local name. This setting is optional. If it is not set, [Repository]realm is used.
The following values are obtained from the [Repository] section of the Vesta configuration file.
- VestaSourceSRPC_host
- The host name of the default (local) repository.
- VestaSourceSRPC_port
- The default TCP port number for repositories.
- realm
- Global user names are formed by appending @realm to the local name. This setting is only used if [UserInterface]realm is not set.
This page was generated automatically by mtex software.Scott Venier, Tim Mann, and Ken Schalk. Yes, it took three of us to delete enough code from other larger programs to leave this small one.
Last modified on Tue Jun 3 23:40:07 PDT 2003 by mann@mumblefrotz.org modified on Fri Jan 31 19:49:31 EST 2003 by ken@xorian.net