version 1.21, 2013/07/16 00:07:52 |
version 1.22, 2014/11/15 14:41:02 |
|
|
display the raw, numerical value (for example, times in seconds since the |
display the raw, numerical value (for example, times in seconds since the |
Epoch, etc.). |
Epoch, etc.). |
.It Fl s |
.It Fl s |
Display information in ``shell output'', suitable for initializing variables. |
Format the output as a line of shell variable assignments. |
.It Fl t Ar timefmt |
.It Fl t Ar timefmt |
Display timestamps using the specified format. |
Display timestamps using the specified format. |
This format is |
This format is |
|
|
.It Cm # |
.It Cm # |
Selects an alternate output form for octal and hexadecimal output. |
Selects an alternate output form for octal and hexadecimal output. |
Non-zero octal output will have a leading zero, and non-zero |
Non-zero octal output will have a leading zero, and non-zero |
hexadecimal output will have ``0x'' prepended to it. |
hexadecimal output will have |
|
.Sq 0x |
|
prepended to it. |
.It Cm + |
.It Cm + |
Asserts that a sign indicating whether a number is positive or negative |
Asserts that a sign indicating whether a number is positive or negative |
should always be printed. |
should always be printed. |
|
|
Displays the type of |
Displays the type of |
.Ar file . |
.Ar file . |
.It Cm Y |
.It Cm Y |
Insert a `` -\*(Gt '' into the output. |
Insert a |
|
.Dq "\ ->\ " |
|
into the output. |
Note that the default output format |
Note that the default output format |
for |
for |
.Cm Y |
.Cm Y |
|
|
It can be one of the following: |
It can be one of the following: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Cm H |
.It Cm H |
``High'' -- specifies the major number for devices from |
High -- specifies the major number for devices from |
.Cm r |
.Cm r |
or |
or |
.Cm d , |
.Cm d , |
the ``user'' bits for permissions from the string form of |
the user bits for permissions from the string form of |
.Cm p , |
.Cm p , |
the file ``type'' bits from the numeric forms of |
the file type bits from the numeric forms of |
.Cm p , |
.Cm p , |
and the long output form of |
and the long output form of |
.Cm T . |
.Cm T . |
.It Cm L |
.It Cm L |
``Low'' -- specifies the minor number for devices from |
Low -- specifies the minor number for devices from |
.Cm r |
.Cm r |
or |
or |
.Cm d , |
.Cm d , |
the ``other'' bits for permissions from the string form of |
the other bits for permissions from the string form of |
.Cm p , |
.Cm p , |
the ``user'', ``group'', and ``other'' bits from the numeric forms of |
the user, group, and other bits from the numeric forms of |
.Cm p , |
.Cm p , |
and the |
and the |
.Ic ls -F |
.Ic ls -F |
|
|
.Cm L |
.Cm L |
for this is optional). |
for this is optional). |
.It Cm M |
.It Cm M |
``Middle'' -- specifies the ``group'' bits for permissions from the |
Middle -- specifies the group bits for permissions from the |
string output form of |
string output form of |
.Cm p , |
.Cm p , |
or the ``suid'', ``sgid'', and ``sticky'' bits for the numeric forms of |
or the |
|
suid, sgid, and sticky bits for the numeric forms of |
.Cm p . |
.Cm p . |
.El |
.El |
.It Cm datum |
.It Cm datum |
|
|
.It Cm Y |
.It Cm Y |
The target of a symbolic link. |
The target of a symbolic link. |
.It Cm Z |
.It Cm Z |
Expands to ``major,minor'' from the rdev field for character or block |
Expands to |
|
.Ar major , Ns Ar minor |
|
from the rdev field for character or block |
special devices and gives size output for all others. |
special devices and gives size output for all others. |
.El |
.El |
.El |
.El |
|
|
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std stat |
.Ex -std stat |
.Sh EXAMPLES |
.Sh EXAMPLES |
Given a symbolic link ``foo'' that points from /tmp/foo to /, you would use |
Given a symbolic link |
|
.Pa foo |
|
that points from |
|
.Pa /tmp/foo |
|
to |
|
.Pa / , |
|
you would use |
.Nm |
.Nm |
as follows: |
as follows: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |