atexpand(3) [debian man page]
atexpand(3) AtFS Toolkit Library atexpand(3) NAME
atExpandAttrs, atExpand - attribute expansion SYNOPSIS
#include <atfs.h> #include <atfstk.h> int atExpandAttrs (Af_key *aso, char *buf, size_t bufSize, FILE *dest, size_t destSize, int mode); int atExpand; DESCRIPTION
atExpandAttrs scans the char buffer buf to the extent of bufSize for strings of the form $__attributeName optionally followed by a delimit- ing (second) dollar sign ($). If such a string is found, the buffer contents up to the character preceding the first dollar sign will be sent to the destination output dest. If an attribute with name attributeName is set for the current attributed software object aso, the citation-string will be substituted by the value of that attribute and appended to the output. Output of buf contents resumes with the first character after the whitespace character or dollar sign delimiting attributeName. Despite the type of the dest argument (pointer to file structure), atExpandAttrs may be caused to copy it's output to a string buffer rather than an open file. In this case, the constant AT_EXPAND_STRING must be given as mode argument and bufSize must be set to indicate the length of the destination buffer dest (will be casted to character pointer). If destSize is to small to hold the result string, atEx- pandAttrs returns a negative value. In the regular case, where output shall be written to a file, the mode parameter must be AT_EXPAND_FILE. The atExpand variable suppresses attribute expansion when set FALSE. The variable may be set either directly from the application program if indirectly by evaluation of the pseudo attribute citation $__xpoff in any buffer scanned by atExpandAttrs. Another pseudo attribute citation $__xpon cancels the effect of a previous $__xpoff and switches attribute citation on again. It does not, however, enable attribute citation if this was disabled explicitly by the application program. DIAGNOSTICS
atExpandAttrs returns -1 on error. Additionally, the atError variable is set and afErrMsg holds a diagnostic message. SEE ALSO
atattribute(3) AtFStk-1.12 Fri Jun 25 16:39:36 1993 atexpand(3)
Check Out this Related Man Page
atfstk_intro(3) AtFS Toolkit Library atfstk_intro(3) NAME
AtFSTK - introduction to the AtFS (Attribute Filesystem) Toolkit Library SYNOPSIS
#include <atfs.h> #include <atfstk.h> char* atVersion (void); void atError (int code; char *msg); int atErrno; char *atErrMsg; int atBindError; char atBindErrorMsg[]; DESCRIPTION
The AtFS Toolkit library (AtFStk) is a library of functions defined on top of the Attribute Filesystem (AtFS). It is designed to facilitate the contruction of AtFS application programs. atVersion returns a version identification string for the AtFS Toolkit library. atError assigns the given error code and the error message msg to the global variables atErrno and atErrMsg. Note: The given error message string (msg) is not copied. atError just assigns its address to atErrMsg. The application has to care about the persistence of the message buffer assigned to atErrMsg. atBindError is a flag indicating that something went wrong during the execution of a function from the version binding subsystem (see atbind(3) and atbindrule(3)). When atBindError is set TRUE, atBindErrorMsg holds an explaining error message. The atBindError flag is cleared upon successfull calls, the message buffer remains unchanged. LIST OF FUNCTIONS AND VARIABLES
Name Appears on PageDescription atAttrName atattribute.3 return name part of attribute atAttrValue atattribute.3 return value part of attribute atBindAddRule atbindrule.3 add version binding rule to internal database atBindCache atbind.3 perform version binding on object cache atBindDelRule atbindrule.3 delete version binding rule from internal database atBindDisplayErrors atbindrule.3report errors while parsing version binding rules (variable) atBindError atfstkintro.3 Version binding error flag (variable) atBindErrorMsg atfstkintro.3Version binding error message (variable) atBindExpandMacro atbind.3external function for macro expansion (variable) atBindListRules atbindrule.3list names of all known version binding rules atBindModeOption atbind.3version binding mode (variable) atBindNoMsg atbind.3 suppress output from version binding rules (variable) atBindOptions atbind.3 parse version binding options from command line atBindRuleFile atbindrule.3evaluate file containing version binding rules atBindSet atbind.3 perform nonunique version binding atBindSetArgv atbind.3 perprocess command line with version binding atBindShowRules atbindrule.3dump internal database of version binding rules atBindTestRule atbindrule.3test existence of version binding rule atBindTrace atbind.3 trace version binding (variable) atBindUsage atbind.3 print usage for version binding options atBindVersion atbind.3 perform unique version binding atCacheKey atcache.3 return unique key attribute atDelVersAlias atversion.3delete version alias name atErrno atfstkintro.3 AtFStk error code (variable) atError atfstkintro.3 set AtFStk error code and message atErrMsg atfstkintro.3 AtFStk error message (variable) atExpand atexpand.3 switch attribute expansion on/off (variable) atExpandAttrs atexpand.3 expand attribue citations in string atFileClassExt atclass.3return file class symbol atFreeAttr atattribute.3 recycle memory of attribute string atGen atversion.3 get generation number from compact representation atIsDerived atclass.3 check if object is from a derived object cache atLocalPath atnetwork.3 map network path to local path atMatchAttr atattribute.3 check if attribute value matches given pattern atNetworkPath atnetwork.3 generate network wide path atRev atversion.3 get revision number from compact representation atRetAttr atattribute.3 return attribute value atSaveCache atcache.3 save object to derived object cache and attach key atScanBinding atbind.3 scan version bind directive atScanStatus atprint.3 scan status string atScanUser atuser.3 scan user name atSetAttr atattribute.3 set or modify attribute atSetAttrFile atattribute.3 set or modify attributes with input from file atSetComment atlog.3 set description, intent or log text atSetVersAlias atversion.3set version alias name atUnlock atlog.3 unlock attributed software object atUserName atuser.3 get user name from user name atUserUid atuser.3 get user id from user structure atUserValid atuser.3 test if user structure is valid atVersion atfstkintro.3 return AtFStk version identification string atVno atversion.3 generate compact version number representation atWriteDate atprint.3 generate string representation of date attribute atWriteMode atprint.3 generate string representation of mode attribute atWriteName atprint.3 write name and path attribute atWriteStatus atprint.3 generate string representation of status attribute SEE ALSO
afintro(3) AUTHOR
Andreas.Lampen@cs.tu-berlin.de AtFStk-1.12 Fri Jun 25 16:39:27 1993 atfstk_intro(3)