This is fls.man in view mode; [Download] [Up]
FLS(1WI) UNIX User's Manual Created: 6 September 1985
NAME
fls - formatted listing of file statistics
USAGE
_f_l_s format [files]
FORMATS
The following is the summary that is printed by _f_l_s when the %? format
is used.
Summary of % formats:
xX means that both integer (x) & string (X) formats supported
All formats support %-p.wX where:
- is an optional sign to left-justify X
p is an optional pad of white spaces
w is an optional maximum width of X
_C_h_a_r _M_e_a_n_i_n_g:
? print this list of formats
% insert %
aA access time
cC change time
gG group id
i inode number
l number of links
mM modification time
n insert a newline
N file name
pP protection modes
s size
t insert a tab
T file type
uU user id
DESCRIPTION
_f_l_s gets information about the named files and allows its display in a
variety of formats. The formats are based on the formatted printing
routines used in C programming, like the newer versions of the _d_a_t_e
program. The program is design to be used in shell scripts.
EXAMPLES
# check user's mail file: cm
set -- `fls "%m %a %s %A" $MAIL`
modifytime=$1
accesstime=$2
size=$3
shift 3
if [ "$size" != 0 ]
then
if test $modifytime -gt $accesstime
then
echo "You have new mail ($size bytes) Last read $*"
else
echo "You have old mail ($size bytes) Last read $*"
fi
else
echo "You have no mail. Last read $*"
A fast long _l_s format with numbers, and one with strings:
fls "%.1T%9P %2l %-10U %-10G %7s %-.10M %N"
fls "%.1T%3p %2l %10u %10g %7s %-.10M %N"
A detailed tabular format:
fls "%n%N:
Last Accessed: %.24A
Last Modified: %.24M
Owner/Group: %-10U %G
File Type: %T
Protections: %P %p
Size: %s
Inode: %i
Links: %l"
Save the file protections, change them, and reset:
oldmode=`fls %p $file`
chmod 777 $file
do_something_to $file
chmod $oldmode $file
SEE ALSO
sh(1), ls(1), stat(2), printf(3)
SYNTAX FOR PROGRAMMERS
The program source contains a function that can be called directly. A
null file name can be used to test the format string.
fls (file, format, buffer)
char *file; /* name of the file to be listed */
char *format; /* format string */
char buffer[]; /* buffer large enough to hold answer */
AUTHOR
Gary Perlman
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.