atcloseexpand(3) [debian man page]
atReadExpand(3) AtFS Toolkit Library atReadExpand(3) NAME
atOpenExpand, atReadExpand, atCloseExpand - read version objects with attribute citations expanded atGetWriteName - get bound version name of a version object opened with atOpenExpand SYNOPSIS
#include <atfs.h> #include <atfstk.h> int atOpenExpand(char *version, int expand_busy) ; int atReadExpand(int desc, char *bufp, int nbytes) ; void atCloseExpand(int desc) ; char *atGetWriteName(int desc) ; extern int atBindError ; extern char atBindErrorMsg[] ; DESCRIPTION
atOpenExpand, atReadExpand, and atCloseExpand are designed as a nearly plug-compatible replacement for the system calls open(2), read(2), and close(2) for reading of AtFS version objects with attribute citations expanded. atOpenExpand opens the file or AtFS version object version for reading with atReadExpand. Version points to the pathname of a file or AtFS version object. If the flag expand_busy is non-zero, attribute citations are expanded in busy versions also. atOpenExpand returns a descriptor that is valid as argument to successive calls to atReadExpand and atCloseExpand. atReadExpand attempts to read nbytes of data from the object referenced by the descriptor desc into the buffer pointed to by bufp. If desc is zero, atReadExpand reads from the standard input. atReadExpand returns the number of bytes actually read. atCloseExpand frees the resources associated with the descriptor desc. atGetWriteName returns a pointer to the bound version name of the version object for which atOpenExpand returned the descriptor desc. DIAGNOSTICS
On error atOpenExpand and atReadExpand return -1 and set errno appropriately. If one of these returns an error and errno is set to ENOMEM, the application may retry the operation, possibly after freeing some memory. If atOpenExpand returns an error and atBindError has a non-zero value, the string version did not select a version object or not a unique version object. In this case atBindErrorMsg contains an appropriate error message. Possible Values of errno after a call to atOpenExpand: ENOMEM Not enough memory could be allocated. EMFILE All available descriptors are in use. All errno values returned by open(2) or read(2). Possible Values of errno after a call to atReadExpand: ENOMEM Not enough memory could be allocated. EBADF Invalid descriptor. BUGS
Since atOpenExpand reads the complete contents of version into memory, it fails on very large version objects. SEE ALSO
intro(2), open(2), read(2), close(2), errno(3), atattribute(3), atbind(3). AtFStk-1.12 Tue Feb 16 20:33:25 1993 atReadExpand(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)