GNU Mailutils Manual (split by node):   Section:   Chapter:FastBack: Programs   Up: mailutils   FastForward: Libraries   Contents: Table of ContentsIndex: Function Index

3.17.6 mailutils stat

The command mailutils stat shows status of a mailbox. The name or URL of the mailbox to operate upon is supplied in the first argument. If not given, the command will display status of the invoking user system mailbox.

$ mailutils stat
type: maildir
path: /var/mail/smith
URL: /var/mail/smith
size: 3498
messages: 24
recent messages: 3
first unseen: 20
uidvalidity: 1338543026
next uid: 87
access: 2016-12-15 09:15:08 +0200

The output format is controlled by the --format (-c) option. Its argument is the desired format string, composed of ordinary characters, which are reporduced on standard output verbatim, backslash sequences, and format specifiers, beginning with ‘%’.

Backslash sequences are interpreted as in C.

A format specifier consists of a leading ‘%’ followed by a letter. Optional ‘:’ may occur between ‘%’ and the letter. Its presense instructs the program to print the description of the corresponding value before the value itself.

The following format sequences are understood:

%f

Name of the mailbox as supplied in the command line. If mailutils stat was used without explicit mailbox argument, ‘%f’ is equivalent to ‘%U’.

%t

Type of the mailbox (‘mbox’, ‘maildir’, etc.). The description string is ‘type’.

%p

Path to the mailbox. In case of remote mailboxes, it is the path part of the mailbox URL. Description string: ‘path’.

%U

URL of the mailbox. Description string: ‘URL’.

%s

Size of the mailbox in octets. Description string: ‘size’.

%c

Number of messages in the mailbox. Description string: ‘messages’.

%r

Number of recent (unread) messages in the mailbox. Description string: ‘recent messages’.

%u

Index of the first unseen message. Description string: ‘first unseen’.

%v

The UIDVALIDITY value. Description string: ‘uidvalidity’.

%n

The UID value which will be assigned to the new message to be incorporated into the mailbox. Description string: ‘next uid’.

%a

Access time of the mailbox, as a number of seconds since the epoch.

%A

Access time of the mailbox in human-readable format.

GNU Mailutils Manual (split by node):   Section:   Chapter:FastBack: Programs   Up: mailutils   FastForward: Libraries   Contents: Table of ContentsIndex: Function Index