.\" Copyright (c) 2001 Christine Maxwell
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" Note: The date here should be updated whenever a non-trivial
.\" change is made to the manual page.
.Dd December 1, 2001
.Dt FINFO 1
.Os FreeBSD
.Sh NAME
.Nm finfo
.Nd display file information
.Sh SYNOPSIS
.Nm
.Op Fl l
.Ar file
.Sh DESCRIPTION
.Nm
displays potentially useful information about the file specified.
Options
.Bl -tag -width Fl
.It Fl l
Display information on symbolic links
.El
.Bd -literal
File  : The resolved physical path to the file.
Type  : The file's type (regular, character/block special, directory,
        symbolic link, fifo, socket, whiteout, or unknown).
Inode : The physical inode of the file, as used by utilities like
        clri(8).
Modes : The User, Group, and Other read/write/execute permissions.
Links : The number of hard links to this file.
Size  : The size of the file in bytes, kilobytes, and megabytes.
        Kilobytes and megabytes are rounded to the nearest hundredth.
Blocks: The number of blocks the file occupies.
Mt Ma : The major number of the device the file is on.
Mt Mi : The minor number of the device the file is on.
IO BS : The ideal input/output block size for the device the file is on.
User  : The owner of the file.
Group : The group of the file.
Last Accessed  : The date and time the file was last accessed.
Last Modifed   : The date and time the file was last modified.
Status Changed : The date and time the status of the file last changed.

    If the file is a character or block special device, the following will
be shown :

Major : The major number of this device.
Minor : The minor number of this device.

    If the file has flags such as those set by chflags, the following will
be shown :

Flags : The file's user definable flags.  These will be one or more of:
        arch, opaque, nodump, sappnd, schg, sunlnk, uappnd, uchg or uunlnk
        for more on what these mean, please refer to chflags(1).
.Ed
.Pp
.Sh EXAMPLES
The following are examples of typical usage :
.Pp
.Dl % finfo /bin/sh
.Dl % finfo /dev/null
.Dl % finfo -l /sys
.Sh DIAGNOSTICS
Exit status is 0 on success or an error number if the command
fails for any of the reasons that lstat, stat, or realpath may fail.
.Sh COMPATIBILITY
.Nm
may not function properly on non FreeBSD systems.
.Sh SEE ALSO
.Xr file 1 ,
.Xr chflags 1 ,
.Xr chflags 2 ,
.Xr stat 2 ,
.Xr realpath 3
.Sh AUTHORS
.An Christine Maxwell Aq cfm@o-o.org .
.Sh BUGS
Dragonflies are pretty.