edquota(1M)                                                     edquota(1M)




 NAME    [Toc]    [Back]
      edquota - edit user disk quotas

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/edquota [-p proto-user] username...

      /usr/sbin/edquota -t

 DESCRIPTION    [Toc]    [Back]
      The edquota command is the quota editor.  One or more user names can
      be specified on the command line.  For each username, a temporary file
      is created with a textual representation of the current disk quotas
      for that user, and an editor is invoked on the file.  The quotas can
      then be modified, new quotas added, etc.  Upon leaving the editor,
      edquota reads the temporary file and modifies the binary quota files
      to reflect the changes made.

      The editor invoked is specified by the EDITOR environment variable.
      It defaults to vi (see vi(1)).

      In order for quotas to be established on a file system, the root
      directory of the file system must contain a file named quotas.  See
      quota(5) for details.

      Quotas can be established only for users whose user ID is less than
      67,000,000.  Attempts to establish quotas for other users will result
      in an error message.  This restriction will be removed in a future
      version of HP-UX.

      Only users who have appropriate privileges can edit quotas.

    Options    [Toc]    [Back]
      -p proto_user  Duplicate the quotas of the user name proto_user for
                     each username.  This is the normal mechanism used to
                     initialize quotas for groups of users.

      -t             Edit the time limits for each file system.  Time limits
                     are set for file systems, not users.  When a user
                     exceeds the soft limit for blocks or inodes on a file
                     system, a countdown timer is started and the user has
                     an amount of time equal to the time limit in which to
                     reduce usage to below the soft limit (the required
                     action is given by the quota command).  If the time
                     limit expires before corrective action is taken, the
                     quota system enforces policy as if the hard limit had
                     been exceeded.  The default time limit of 0 is
                     interpreted to mean the value in <sys/quota.h>, or one
                     week (7 days).  Time units of sec(onds), min(utes),
                     hour(s), day(s), week(s), and month(s) are understood.
                     Time limits are printed in the greatest possible time
                     unit such that the value is greater than or equal to



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 edquota(1M)                                                     edquota(1M)




                     one.

    Temporary File Formats    [Toc]    [Back]
      Here is an example of the temporary file created for editing user
      block and inode quotas:

           fs /mnt blocks (soft = 100, hard = 120) inodes (soft = 0, hard = 0)
           fs / blocks (soft = 1000, hard = 1200) inodes (soft = 200, hard = 200)

      Here is the format for editing quota time limits:

           fs /mnt blocks time limit = 10.00 days, files time limit = 20.00 days
           fs / blocks time limit = 0 (default), files time limit = 0 (default)

      When editing (default) values, it is not necessary to remove the
      (default) string.  For example, to change the blocks time limit for /,
      changing the 0 to 4 days is sufficient.

 WARNINGS    [Toc]    [Back]
      When establishing quotas for a user who has had none before, (for
      either blocks or inodes), the quota statistics for that user do not
      include any currently occupied file system resources.  Therefore, it
      is necessary to run quotacheck (see quotacheck(1M)) to collect
      statistics for that user's current usage of that file system.  See
      quota(5) for a detailed discussion of this topic.

      edquota will only edit quotas on local file systems.

 AUTHOR    [Toc]    [Back]
      edquota was developed by the University of California, Berkeley, and
      by Sun Microsystems, Inc.

 FILES    [Toc]    [Back]
      /etc/fstab               Static information about the file systems.
      /etc/mnttab              Mounted file system table
      directory/quotas         Quota statistics static storage for a file
                               system, where directory is the root of the
                               file system as specified to the mount command
                               (see mount(1M)).

 SEE ALSO    [Toc]    [Back]
      vi(1), quota(1), quotacheck(1M), quotacheck_hfs(1M), quota(5).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003