Differential D35783 Diff 108054 bin/ls/ls.1

Changeset View

Standalone View

bin/ls/ls.1

	Show All 26 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" 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			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)ls.1 8.7 (Berkeley) 7/29/94			.\" @(#)ls.1 8.7 (Berkeley) 7/29/94
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd August 31, 2020			.Dd July 11, 2022
	.Dt LS 1			.Dt LS 1
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm ls			.Nm ls
	.Nd list directory contents			.Nd list directory contents
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1\&,			.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuvwxy1\&,
	.Op Fl -color Ns = Ns Ar when			.Op Fl -color Ns = Ns Ar when
	.Op Fl D Ar format			.Op Fl D Ar format
	.Op Ar			.Op Ar
	.Sh DESCRIPTION			.Sh DESCRIPTION
	For each operand that names a			For each operand that names a
	.Ar file			.Ar file
	of a type other than			of a type other than
	directory,			directory,
	▲ Show 20 Lines • Show All 342 Lines • ▼ Show 20 Lines
	same modification timestamp.			same modification timestamp.
	.It Fl u			.It Fl u
	Use time of last access,			Use time of last access,
	instead of time of last modification			instead of time of last modification
	of the file for sorting			of the file for sorting
	.Pq Fl t			.Pq Fl t
	or printing			or printing
	.Pq Fl l .			.Pq Fl l .
				.It Fl v
				Sort by natural ordering (using
				.Xr strverscmp 3
				instead of
				.Xr strcoll 3
				as the comparison function).
				pauamma_gundo.comUnsubmitted Not Done Inline Actions I'd explain here instead, perhaps with examples. Sending the reader to library manual pages they may not be able to puzzle out easily or at all will only discourage them. pauamma_gundo.com: I'd explain here instead, perhaps with examples. Sending the reader to library manual pages…
				obiwacAuthorUnsubmitted Done Inline Actions Gotcha, that makes sense obiwac: Gotcha, that makes sense
	.It Fl w			.It Fl w
	Force raw printing of non-printable characters.			Force raw printing of non-printable characters.
	This is the default			This is the default
	when output is not to a terminal.			when output is not to a terminal.
	This option is not defined in			This option is not defined in
	.St -p1003.1-2001 .			.St -p1003.1-2001 .
	.It Fl x			.It Fl x
	The same as			The same as
	▲ Show 20 Lines • Show All 487 Lines • ▼ Show 20 Lines
	.Fl o ,			.Fl o ,
	the			the
	.Nm			.Nm
	utility conforms to			utility conforms to
	.St -p1003.1-2001			.St -p1003.1-2001
	and			and
	.St -p1003.1-2008 .			.St -p1003.1-2008 .
	The options			The options
	.Fl B , D , G , I , T , U , W , Z , b , h , w , y			.Fl B , D , G , I , T , U , W , Z , b , h , v , w , y
	and			and
	.Fl ,			.Fl ,
	are non-standard extensions.			are non-standard extensions.
	.Pp			.Pp
	The ACL support is compatible with			The ACL support is compatible with
	.Tn IEEE			.Tn IEEE
	Std\~1003.2c			Std\~1003.2c
	.Pq Dq Tn POSIX Ns .2c			.Pq Dq Tn POSIX Ns .2c
	Show All 23 Lines