CGI Services Architecture
|
CGI Services Architecture
|
|
AWK FunctionsThis is the list of the AWK functions that are currently provided by the relevant CSA libraries. As it was the case with Rc Functions, describing all of them in this document will be a major task. In the meantime please refer directly to the comments in the associated library files._authset _authclear _awkassign _bool _buffer _cgivar _computerdate _creat _envtoxml _escape _escreg _extract _formarea _formhidden _formradio _formselect _formtext _hdrtocgi _html _isemail _isipaddr _isodate _isoencode _isuri _localdate _mrwresponse _newcall _nlsmap _parsecpi _pathinfo _qpdecode _qpencode _rcescape _rcget _rcset _rdfprint _request _response _sendmail _sort _stat _strdup _sys _tbltordf _uncgi _unesctbl _uniq _uriencode _usercpi _userencode_1 _userencode_2 _userencode_3 _userproc _wbmsg _wsresponse _xmldecode _xmlencode AWK function overridesSimilarly to what happens with Rc Functions, it is possible to provide local copies also of any AWK functions, as well as providing new application-level functions that are not present in the main library. This needs special provisions on the part of CSA, as AWK does not allow functions to be re-defined. Local copies of functions except _userproc() (see Input Hook and Output Hook) must be written to$CSA_ROOT/lib/include/. For instance, a local copy of
$CSA_INSTALL/lib/include/_xmldecode.awk will have to be written to
$CSA_ROOT/lib/include/_xmldecode.awk. Whenever the local repository is changed, either to add new function files or to change existing ones, the
function cache must be re-built. The cache is located in
$TMPDIR/fncache.awk, and it must be manually removed to force a re-build the next time a CSA program is run.
Whenever you upgrade to a new CSA version you must make sure that the
$TMPDIR/fncache.awk file of
every CSA application is re-built with the updated functions. This can be done by setting
CSA_AWK_NEWCACHE=1 in the main CSA script (CGI front-end). Do not forget to unset it again (or set it to
0)after all caches have been re-built, or your CSA applications will execute slower.
Local function libraries, other than overrides, can also be provided by writingthem to
$CSA_ROOT/lib/ and passing them as arguments to the
csaAwk()
rc function from within application-level programs.
CSA AWK global variablesThis is the complete list of global CSA names that are defined in the relevant AWK library functions. Please refer to the associated files for more info on them._ARGSIZE _BUFFER _CGILEN _CGIVAL _CHARMAP _CSAINST _CURSOR _FORMAT _INCLUDEPATH _LANG _MAPCHAR _MAXARG _MAXSIZE _MRW _MSG _NLSMAP _NOCPI _O_APPEND _O_ATTACH _O_CRUSH _O_CURR _O_NOENC _O_PATHINFO _O_REQUEST _O_RESPONSE _O_TRUNC _O_UPNAME _OUT _OUTH _PID _RANDOM _RDFCDAT _RDFCNAM _RDFCTYP _RDFDATA _RDFMAP _RDFPRINT _RDFTYPE _REQ_CHARSET _RESP_CHARSET _RESULT _RLMATCH _RMATCH _RRMATCH _STDERR _STDOUT _TBL _TBLH _TBLS _TBLSH _TMPSTEM _TOOBIG _TPLSTOP _UPLOAD _XMLTOP Trackbacks (0) | New trackback | Print |