NAME¶

atWriteStatus, atWriteMode, atWriteDate, atWriteName, atScanStatus - print and scan special attribute values

SYNOPSIS¶

#include <atfs.h>
#include <atfstk.h>

char* atWriteStatus (Af_key *aso; int verbose);

char* atWriteMode (Af_key *aso);

char* atWriteDate (Af_key *aso, char *dateAttribute);

char* atWriteName (Af_key *aso, char *path);

int atScanStatus (char *statusStr);

DESCRIPTION¶

atWriteStatus returns a string representation of Asos AF_STATE attribute. With the verbose 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.

atWriteMode generates a ls -l(1) like (e.g. -rwxr-xr-x) string representation of the AF_MODE attribute. It returns its result in static memory, which will be overwritten on subsequent calls.

atWriteDate produces a date string from the given dateAttribute to be used for ls -l(1) like output (e.g. Jan  8 11:07 or Jul 10  1992). 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.

atWriteName generates a bound pathname from path and aso.

atScanStatus converts an status string to an internal numeric status value. It understands various abbreviations, including the one character status strings generated by atWriteStatus.

.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.