Rechercher une page de manuel
vos_setfields
Langue: en
Version: 2009-03-17 (debian - 07/07/09)
Section: 1 (Commandes utilisateur)
NAME
vos_setfields - Sets the quota or clear the access counter on a volume.SYNOPSIS
vos setfields -id <volume name or ID>-maxquota <quota (KB)> [-clearuse]
[-cell <cell name>] [-noauth] [-localauth]
[-verbose] [-encrypt] [b<-noresolve>] [-help]
vos se -id <volume name or ID>
-maxquota <quota (KB)> [-clearuse]
[-cell <cell name>] [-noauth] [-localauth]
[-verbose] [-encrypt] [b<-noresolve>] [-help]
DESCRIPTION
The vos setfields command can set the quota on a volume, and it can clear the access counter on a volume. This command differs from fs setquota because only the volume name is needed to set the quota, whereas the path to the volume is needed with fs setquota.If the -maxquota and -clearuse flags are missing, then no action is taken.
CAUTIONS
This command is not effective on read-only or backup volumes.OPTIONS
- -id <volume name or id>
- Identifies the volume on which to operate, either by its complete name or volume ID number.
- -maxquota <cell name>
- Sets the maximum amount of file server disk space the volume can occupy. Specify the number of one-kilobyte blocks as a positive integer (1024 is one megabyte). A value of 0 sets an unlimited quota, but the size of the disk partition that houses the volume places an absolute limit on the volume's size.
- -clearuse
- Clears the access counter on a volumes, which is shown as "X accesses in the past day (i.e., vnode references)" in the vos examine output.
- -cell <cell name>
- Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see vos(1).
- -noauth
- Assigns the unprivileged identity "anonymous" to the issuer. Do not combine this flag with the -localauth flag. For more details, see vos(1).
- -localauth
- Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. The vos command interpreter presents it to the Volume Server and Volume Location Server during mutual authentication. Do not combine this flag with the -cell argument or -noauth flag. For more details, see vos(1).
- -encrypt
- Encrypts the command so that the operation's results are not transmitted across the network in clear text.
- -noresolve
- Shows all servers as IP addresses instead of the DNS name. This is very useful when the server address is registered as 127.0.0.1 or when dealing with multi-homed servers. The -noresolve option is available in OpenAFS versions 1.4.8 or later and 1.5.35 or later.
- -verbose
- Produces on the standard output stream a detailed trace of the command's execution. If this argument is omitted, only warnings and error messages appear.
- -help
- Prints the online help for this command. All other valid options are ignored.
OUTPUT
This command produces no output other than error messages.EXAMPLES
To set a 123KB quota on the root.cell volume, the following command may be used:% vos setfields -id root.cell -maxquota 123
To clear the access counter on the root.cell volume, use the following command:
% vos setfields -id root.cell -clearuse
The above commands may be combined as follows:
% vos setfields -id root.cell -maxquota 123 -clearuse
PRIVILEGE REQUIRED
The issuer must be listed in the /etc/openafs/server/UserList file on the machine specified with the -server argument and on each database server machine. If the -localauth flag is included, the issuer must instead be logged on to a server machine as the local superuser "root".SEE ALSO
fs_setquota(1), vos(1), vos_examine(1)COPYRIGHT
Copyright 2009 Jason Edgecombe <jason@rampaginggeek.com>This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre