da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.fp 5 CW
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de Af
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ds ;G \\*(;G\\f\\$1\\$3\\f\\$2
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.if !\\$4 .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de aF
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ie \\$3 .ft \\$1
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.el \{\
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ds ;G \&
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nr ;G \\n(.f
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin\\*(;G
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft \\n(;G \}
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de L
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de LR
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de RL
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EX \" start example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ta 1i 2i 3i 4i 5i 6i
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.RS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PD 0
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft 5
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nf
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EE \" end example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.fi
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PD
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.RE
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TH STRLS 3
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH NAME
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfmtls \- format file information in buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH SYNOPSIS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.EX
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin#include <ls.h>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulknerchar* fmtls(char* \fIbuf\fP, char* \fIname\fP, struct stat* \fIst\fP, char* \fIinfo\fP, char* \fIlink\fP, int \fIflags\fP);
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.EE
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH DESCRIPTION
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L fmtls
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinformats
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR ls (1)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstyle file information into the buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR buf .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinA pointer to the trailing 0 in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I buf
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis returned.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I name
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis the file name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I st
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis a pointer to the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B "struct stat
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinstatus information for
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I name
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinobtained from one of the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR stat (2)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinroutines.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I info
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis an additional string that will appear before
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I name
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinin
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I buf
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I link
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis the name of the related hard or soft link file.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinBoth
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I info
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I link
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinmay be 0.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I flags
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincontrols the format style and may be a combination of the following:
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_ATIME
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinUse
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I st->st_atime
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinrather than
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I st->st_mtime
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfor
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR LS_LONG .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_CTIME
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinUse
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I st->st_mtime
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinrather than
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I st->st_mtime
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfor
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR LS_LONG .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_BLOCKS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinList the number of blocks.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_INUMBER
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinList the file serial number (inode number).
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_LONG
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinList the file mode, link count, user and group name,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinsize or major/minor device number, and date along with the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfile name.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_MARK
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe file name is appended with
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L /
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfor directories,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L @
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfor symbolic links,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfor executable files.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_NOGROUP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinOmit the group name from
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR LS_LONG .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_NOUSER
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinOmit the user name from
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR LS_LONG .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe user and group fields are each
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_W_NAME
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincharacters wide,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinthe
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_INUMBER
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfield is
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_W_INUMBER
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincharacters wide,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_BLOCKS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinfield is
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B LS_W_BLOCKS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincharacters wide.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH "SEE ALSO"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinls(1), stat(2), strmode(3)