xfsdq, xfsrq - XFS dump and restore quota


SYNOPSIS

       xfsdq [ -g|-u ] filesystem
       xfsrq [ -g|-u ] xfsdump_quotas


DESCRIPTION

       xfsdq  outputs a summary of the disk quotas for the speci­
       fied XFS filesystem for either all users declared  in  the
       local  /etc/passwd  file,  or  all  groups declared in the
       local /etc/group file.

       The output format exactly matches  that  produced  by  the
       IRIX  repquota  command,  given the -e option.  The format
       contains two lines for each user/group -  the  first  line
       contains  the  filesystem device file, the second contains
       the uid/gid, block soft limit,  block  hard  limit,  inode
       soft  limit,  and  finally  the  inode hard limit (in that
       order).

       xfsdump  runs  xfsdq  on  those  filesystems  with   quota
       enabled,  and  redirects  the output (from standard output
       stream) to a file which is subsequently stored on the dump
       device.   For  user quota, this file is named xfsdump_quo­
       tas, for group quota  it  is  named  xfsdump_quotas_group.
       Thus,  the  primary  purpose  of xfsdq is to maintain this
       dump file format between IRIX and Linux, such that xfsdump
       backups remain interchangable.

       xfsrq  is  a simple wrapper around setquota(8) which auto­
       mates the restoration of quota information using this xfs­
       dump_quotas file.

       The  -u  (user)  option  specifies  user  quota  should be
       reported.  This is the default.

       The -g (group) option specifies that group quota are to be
       reported.

       The  filesystem  argument  should  be the filesystem mount
       point, and not the device.


RESTORE

       In order to restore quota  information  using  the  output
       from  xfsdq,  one  must  first  restore a copy of the xfs­
       dump_quotas file from the dump device.

       On Linux, user quota can then be restored using:

               # xfsrq -u xfsdump_quotas

       On IRIX, the equivalent command is:



NOTES

       Only user quota are supported  by  both  Linux  and  IRIX.
       Group  quota  are  not supported on IRIX and project quota
       are not supported on Linux.

       The soft and hard block limits reported by  xfsdq  are  in
       units of 512 bytes for compatibility with IRIX.  The Linux
       quota utilities, e.g.  quota(1)  and  repquota(8),  report
       blocks  in units of 1024 bytes - xfsrq performs the neces­
       sary conversions automatically.


FILES

       /etc/mtab           default filesystems
       /etc/passwd         default set of users
       /etc/passwd         default set of groups

SEE ALSO

       quota(1), repquota(8), setquota(8), xfsdump(8), xfs(5).


Man(1) output converted with man2html