.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: atprint.3[7.0] Fri Jun 25 16:39:43 1993 andy@cs.tu-berlin.de frozen $
..
.TH atprint 3 "Fri Jun 25 16:39:43 1993" "AtFStk-1.12" "AtFS Toolkit Library"
.SH NAME
atWriteStatus, atWriteMode, atWriteDate, atWriteName, atScanStatus \- print and
scan special attribute values
.SH SYNOPSIS
#include <atfs.h>
.br
#include <atfstk.h>
.sp
.ta 1.2c
char*	atWriteStatus (Af_key *aso; int verbose);
.sp
char*	atWriteMode (Af_key *aso);
.sp
char*	atWriteDate (Af_key *aso, char *dateAttribute);
.sp
char*	atWriteName (Af_key *aso, char *path);
.sp
int	atScanStatus (char *statusStr);
.sp
.SH DESCRIPTION
\fIatWriteStatus\fP returns a string representation of \fIAso\fPs
AF_STATE attribute. With the \fIverbose\fP argument TRUE, atWriteStatus
returns a long (8 character) status name. Otherwise, on FALSE, it
returns a one character short representation. The result value is a
statically defined string in any case.
.LP
\fIatWriteMode\fP generates a ls -l(1) like (e.g. \fC-rwxr-xr-x\fP)
string representation of the AF_MODE attribute. It returns its result
in static memory, which will be overwritten on subsequent calls.
.LP
\fIatWriteDate\fP produces a date string from the given
\fIdateAttribute\fP to be used for ls -l(1) like
output (e.g. \fCJan\ \ 8\ 11:07\fP or \fCJul\ 10\ \ 1992\fP).
The format of the date string depends on the value of the date
attribute. The string is always 12 characters long and begins with the
month and day. For dates younger than 6 months, the third field is the
time, for dates older than 6 months, the year. The result string
resides in static memory, which will be overwritten on subsequent
calls.
.LP
\fIatWriteName\fP generates a bound pathname from \fIpath\fP and
\fIaso\fP.
.LP
\fIatScanStatus\fP converts an status string to an internal numeric
status value. It understands various abbreviations, including the
one character status strings generated by atWriteStatus.
.SH .BUGS
The format switch in afWriteDate (for dates older than six months)
does not happen at exactly the right time. It may be a few days later.