1.\" $NetBSD: stat.1,v 1.4 2002/05/09 17:52:03 atatat Exp $
2.\"
3.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Andrew Brown and Jan Schaumann.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
--- 19 unchanged lines hidden (view full) ---
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.\" $FreeBSD: head/usr.bin/stat/stat.1 97953 2002-06-06 19:27:17Z dougb $
38.\"
39.Dd April 24, 2002
40.Dt STAT 1
41.Os
42.Sh NAME
43.Nm stat
44.Nd display file status
45.Sh SYNOPSIS
46.Nm
47.Op Fl FLn
48.Oo
49.Fl f Ar format |
50.Fl l |
51.Fl r |
52.Fl s |
53.Fl x
54.Oc
55.Op Fl t Ar timefmt
56.Op Ar
57.Sh DESCRIPTION
58The
59.Nm
60utility displays information about the file pointed to by
61.Ar file .
62Read, write or execute permissions of the named file are not required, but
63all directories listed in the path name leading to the file must be
64searchable. If no argument is given,
65.Nm
66displays information about the file descriptor for standard input.
67.Pp
68The information displayed is obtained by calling
69.Xr lstat 2
70with the given argument and evaluating the returned structure.
71.Pp
72The options are as follows:
73.Bl -tag -width Ds
74.It Fl F
75As in
--- 21 unchanged lines hidden (view full) ---
97Do not force a newline to appear at the end of each piece of output.
98.It Fl f Ar format
99Display information using the specified format. See the FORMATS section
100for a description of valid formats.
101.It Fl l
102Display output in
103.Ic ls Fl lT
104format.
105.It Fl r
106Display raw information. That is, for all the fields in the stat-structure,
107display the raw, numerical value (for example, times in seconds since the
108epoch, etc.)
109.It Fl s
110Display information in ``shell output'', suitable for initializing variables.
111.It Fl x
112Display information in a more verbose way as known from some Linux
--- 322 unchanged lines hidden ---
2.\"
3.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Andrew Brown and Jan Schaumann.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
--- 19 unchanged lines hidden (view full) ---
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.\" $FreeBSD: head/usr.bin/stat/stat.1 97953 2002-06-06 19:27:17Z dougb $
38.\"
39.Dd April 24, 2002
40.Dt STAT 1
41.Os
42.Sh NAME
43.Nm stat
44.Nd display file status
45.Sh SYNOPSIS
46.Nm
47.Op Fl FLn
48.Oo
49.Fl f Ar format |
50.Fl l |
51.Fl r |
52.Fl s |
53.Fl x
54.Oc
55.Op Fl t Ar timefmt
56.Op Ar
57.Sh DESCRIPTION
58The
59.Nm
60utility displays information about the file pointed to by
61.Ar file .
62Read, write or execute permissions of the named file are not required, but
63all directories listed in the path name leading to the file must be
64searchable. If no argument is given,
65.Nm
66displays information about the file descriptor for standard input.
67.Pp
68The information displayed is obtained by calling
69.Xr lstat 2
70with the given argument and evaluating the returned structure.
71.Pp
72The options are as follows:
73.Bl -tag -width Ds
74.It Fl F
75As in
--- 21 unchanged lines hidden (view full) ---
97Do not force a newline to appear at the end of each piece of output.
98.It Fl f Ar format
99Display information using the specified format. See the FORMATS section
100for a description of valid formats.
101.It Fl l
102Display output in
103.Ic ls Fl lT
104format.
105.It Fl r
106Display raw information. That is, for all the fields in the stat-structure,
107display the raw, numerical value (for example, times in seconds since the
108epoch, etc.)
109.It Fl s
110Display information in ``shell output'', suitable for initializing variables.
111.It Fl x
112Display information in a more verbose way as known from some Linux
--- 322 unchanged lines hidden ---