Section 3: library functions
cgtsvx.f – Synopsis Functions/Subroutines subroutine cgtsvx (FACT, TRANS, N, NRHS, DL, D, DU, DLF, DF, DUF, DU2, IPIV, B, LDB, X, LDX, RCOND, FERR, BERR, WORK, RWORK, INFO) CGTSVX computes the solution to system of linear equations A * X = B for GT matrices Function/Subroutine Documentation subroutine cgtsvx (characterFACT, characterTRANS, integerN, integerNRHS, complex, dimension(…
cgtsv.f – Synopsis Functions/Subroutines subroutine cgtsv (N, NRHS, DL, D, DU, B, LDB, INFO) CGTSV computes the solution to system of linear equations A * X = B for GT matrices Function/Subroutine Documentation subroutine cgtsv (integerN, integerNRHS, complex, dimension( * )DL, complex, dimension( * )D, complex, dimension( * )DU, complex, dimension( ldb, * )B, integerLDB,…
cgtrfs.f – Synopsis Functions/Subroutines subroutine cgtrfs (TRANS, N, NRHS, DL, D, DU, DLF, DF, DUF, DU2, IPIV, B, LDB, X, LDX, FERR, BERR, WORK, RWORK, INFO) CGTRFS Function/Subroutine Documentation subroutine cgtrfs (characterTRANS, integerN, integerNRHS, complex, dimension( * )DL, complex, dimension( * )D, complex, dimension( * )DU, complex, dimension( * )DLF, complex, dimension( * )DF, complex,…
cgtcon.f – Synopsis Functions/Subroutines subroutine cgtcon (NORM, N, DL, D, DU, DU2, IPIV, ANORM, RCOND, WORK, INFO) CGTCON Function/Subroutine Documentation subroutine cgtcon (characterNORM, integerN, complex, dimension( * )DL, complex, dimension( * )D, complex, dimension( * )DU, complex, dimension( * )DU2, integer, dimension( * )IPIV, realANORM, realRCOND, complex, dimension( * )WORK, integerINFO) CGTCON Purpose: CGTCON estimates…
NAME libcgraph – abstract graph library SYNOPSIS #include <graphviz/cgraph.h> TYPES Agraph_t; Agnode_t; Agedge_t; Agdesc_t; Agdisc_t; Agsym_t; GRAPHS Agraph_t *agopen(char *name, Agdesc_t kind, Agdisc_t *disc); int agclose(Agraph_t *g); Agraph_t *agread(void *channel, Agdisc_t *); void agreadline(int line_no); void agsetfile(char *file_name); Agraph_t *agconcat(Agraph_t *g, void *channel, Agdisc_t *disc) int agwrite(Agraph_t *g, void *channel); int agnnodes(Agraph_t *g), agnedges(Agraph_t *g);…
NAME cgiwrap_writevf – a wrapper for vprintf SYNOPSIS #include <cgi/cgiwrap.h> NEOERR *cgiwrap_writevf(const char *fmt, va_list ap); ARGUMENTS fmt – standard printf fmt string ap – stdarg argument pointer DESCRIPTION cgiwrap_writevf is the formatted output command that replaces vprintf or fvprintf(stdout) in a standard CGI It is also used by cgiwrap_writef (the actual wrapped function is…
NAME cgiwrap_writef – a wrapper for printf SYNOPSIS #include <cgi/cgiwrap.h> NEOERR *cgiwrap_writef(const char *fmt, …) ATTRIBUTE_PRINTF(1, 2); ARGUMENTS fmt – standard printf fmt string and args DESCRIPTION cgiwrap_writef is the formatted output command that replaces printf or fprintf(stdout) in a standard CGI RETURN VALUE None SEE ALSO cgiwrap_iterenv(3), cgiwrap_putenv(3), cgiwrap_init_emu(3), cgiwrap_writef(3), cgiwrap_init_std(3), cgiwrap_writevf(3), cgiwrap_read(3), cgiwrap_write(3),…
NAME cgiwrap_write – wrapper for the fwrite(stdout) SYNOPSIS #include <cgi/cgiwrap.h> NEOERR *cgiwrap_write(const char *buf, int buf_len); ARGUMENTS buf – a character buffer buf_len – the length of the buffer in buf DESCRIPTION cgiwrap_write is the block data output function for cgiwrap that replaces fwrite(stdout) in regular CGIs RETURN VALUE None SEE ALSO cgiwrap_iterenv(3), cgiwrap_putenv(3), cgiwrap_init_emu(3),…
NAME cgiwrap_read – cgiwrap input function SYNOPSIS #include <cgi/cgiwrap.h> void cgiwrap_read(char *buf, int buf_len, int *read_len); ARGUMENTS buf – a pre-allocated buffer to read the data into buf_len – the size of the pre-allocated buffer DESCRIPTION cgiwrap_read is used to read incoming data from the client, usually from a POST or PUT HTTP request. It…
NAME cgiwrap_putenv – wrap the putenv call SYNOPSIS #include <cgi/cgiwrap.h> NEOERR *cgiwrap_putenv(const char *k, const char *v); ARGUMENTS k – the env var name v – the new value for env var k DESCRIPTION cgiwrap_putenv wraps the putenv call. This is mostly used by the cgi_debug_init function to create an artificial environment. This version differs…
NAME cgiwrap_iterenv – iterater for env vars SYNOPSIS #include <cgi/cgiwrap.h> NEOERR *cgiwrap_iterenv(int n, char **k, char **v); ARGUMENTS n – variable to return. This should start at 0 and increment until you receive a NULL return value. DESCRIPTION cgiwrap_iterenv allows a program to iterate over all the environment variables. This is probably mostly used by…
NAME cgiwrap_init_std – Initialize cgiwrap with default functions SYNOPSIS #include <cgi/cgiwrap.h> void cgiwrap_init_std(int argc, char **argv, char **envp); ARGUMENTS the arguments to main, namely argc/argv/envp DESCRIPTION cgiwrap_init_std will initialize the cgiwrap subsystem to use the default CGI functions, ie getenv/putenv/stdio. In reality, all this is doing is setting up the data for the cgiwrap_iterenv() function….
NAME cgiwrap_init_emu – initialize cgiwrap for emulated use SYNOPSIS #include <cgi/cgiwrap.h> void cgiwrap_init_emu(void *data, READ_FUNC read_cb, WRITEF_FUNC writef_cb, WRITE_FUNC write_cb, GETENV_FUNC getenv_cb, PUTENV_FUNC putenv_cb, ITERENV_FUNC iterenv_cb); ARGUMENTS data – user data to be passed to the specified callbacks read_cb – a cb to replace fread(stdin) writef_cb – a cb to repalce fprintf(stdout) write_cb – a…
NAME cgiwrap_getenv – the wrapper for getenv SYNOPSIS #include <cgi/cgiwrap.h> NEOERR *cgiwrap_getenv(const char *k, char **v); ARGUMENTS k – the environment variable to lookup DESCRIPTION cgiwrap_getenv wraps the getenv function for access to environment variables, which are used to pass data to CGI scripts. This version differs from the system getenv in that it makes…
NAME cgi_vredirect – send an HTTP 302 redirect response SYNOPSIS #include <cgi/cgi.h> void cgi_vredirect(CGI *cgi, int uri, const char *fmt, va_list ap); ARGUMENTS cgi – cgi struct uri – whether the URL is full (1) or path only (0) fmt – printf format string ap – stdarg va_list DESCRIPTION cgi_vredirect is mostly used internally, but…
NAME cgi_url_validate – validate that url is of an allowed format SYNOPSIS #include <cgi/cgi.h> NEOERR *cgi_url_validate(const char *buf, char **esc); ARGUMENTS buf – a 0 terminated string DESCRIPTION cgi_url_validate will check that a URL starts with one of the accepted safe schemes. If not, it returns "#" as a safe substitute. Currently accepted schemes are…
NAME cgi_url_unescape – unescape an url encoded string SYNOPSIS #include <cgi/cgi.h> char *cgi_url_unescape(char *buf); ARGUMENTS buf – a 0 terminated string DESCRIPTION cgi_url_unescape will do URL unescaping on the passed in string. This function modifies the string in place This function will decode any %XX character, and will decode + as space SEE ALSO cgi_debug_init(3),…
NAME cgi_url_escape_more – url escape a string SYNOPSIS #include <cgi/cgi.h> NEOERR *cgi_url_escape_more(const char *buf, char **esc, const char *other); ARGUMENTS buf – a 0 terminated string other – a 0 terminated string of characters to escape DESCRIPTION cgi_url_escape_more will do URL escaping on the passed in string, and return a newly allocated string that is…
NAME cgi_url_escape – url escape a string SYNOPSIS #include <cgi/cgi.h> NEOERR *cgi_url_escape(const char *buf, char **esc); ARGUMENTS buf – a 0 terminated string DESCRIPTION cgi_url_escape will do URL escaping on the passed in string, and return a newly allocated string that is escaped. Characters which are escaped include control characters, %, ?, +, space, =,…
NAME cgi_register_parse_cb – Register a parse callback SYNOPSIS #include <cgi/cgi.h> NEOERR *cgi_register_parse_cb(CGI *cgi, const char *method, const char *ctype, void *rock, CGI_PARSE_CB parse_cb); ARGUMENTS cgi – a CGI struct method – the HTTP method you want to handle, or * for all ctype – the HTTP Content-Type you want to handle, or * for all…