serializer.h File Reference

Header for data-to-disk component. More...

#include "pair.h"

Include dependency graph for serializer.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	serialnode_t
	Associates a class name with a handler function. More...
struct	serial_t
	root of handler associations More...
Defines
#define	FERROR   error
	default error handler
#define	PREFIX   "tmp/"
	default work directory
Enumerations
enum	eserial { CLASSES = 1 }
	serializer constants More...
enum	eserialerr {   ERROK, ERRGENERAL, ERRDIGEST, ERRPROCESS,   ERRMATH, ERRMATHWRITE, ERRMAGICK, ERRMAGICKREAD,   ERRMAGICKTRIM, ERRMAGICKWRITE, ERRDVIPNG, ERRDVIPNGWRITE,   ERRDVIPNGOUTPUT }
	Houses central error constants whose adherent strings (see error ) are communicated to the browser. More...
enum	epcerror { PCOPEN, PCCLOSE }
	Corresponds to open and close error display. More...
Functions
int	serialize (char *, pair_t *)
	Creates hash digest of source and siphons either to specific or generic renderer.
int	digest (char *, char **)
	Hashes source into digest form (MD5).
void	error (int)
	Parses eserialerr and displays to browser wrapped in span.

---

Detailed Description

Header for data-to-disk component.

Definition in file serializer.h.

---

Define Documentation

#define FERROR   error

default error handler Definition at line 9 of file serializer.h.

#define PREFIX   "tmp/"

default work directory Definition at line 11 of file serializer.h. Referenced by math().

---

Enumeration Type Documentation

enum epcerror

Corresponds to open and close error display. Enumeration values: PCOPEN  open tag PCCLOSE  close tag Definition at line 52 of file serializer.h. { PCOPEN, PCCLOSE };

enum eserial

serializer constants Enumeration values: CLASSES  distinct classes, whose first is default Definition at line 14 of file serializer.h. { CLASSES = 1 };

enum eserialerr

Houses central error constants whose adherent strings (see error ) are communicated to the browser. Enumeration values: ERROK  no error ERRGENERAL  internal, generic error ERRDIGEST  error producing hash ERRPROCESS  error opening process with popen ERRMATH  generic LaTeX error ERRMATHWRITE  error writing LaTeX product ERRMAGICK  ImageMagick initialization error ERRMAGICKREAD  error reading image ERRMAGICKTRIM  error paring image ERRMAGICKWRITE  error serializing image ERRDVIPNG  error initializing dvipng ERRDVIPNGWRITE  error writing product ERRDVIPNGOUTPUT  error displaying product Definition at line 35 of file serializer.h. { ERROK, ERRGENERAL, ERRDIGEST, ERRPROCESS, ERRMATH, ERRMATHWRITE, ERRMAGICK, ERRMAGICKREAD, ERRMAGICKTRIM, ERRMAGICKWRITE, ERRDVIPNG, ERRDVIPNGWRITE, ERRDVIPNGOUTPUT };

---

Function Documentation

int digest (  char *  pcin, char **  ppcdigest )

Hashes source into digest form (MD5). Parameters: pcin  digestible ppcdigest  digest receivable, initialized with NONE Returns: status according to eserialerr . Definition at line 56 of file serializer.c. References ERRDIGEST, and EVAL. Referenced by serialize(). { EVP_MD_CTX mdctx; unsigned char md_value[EVP_MAX_MD_SIZE]; unsigned int md_len, u; int iret = ERROK; char ac[3]; EVP_DigestInit(&mdctx, EVP_md5()); EVP_DigestUpdate(&mdctx, pcin, strlen(pcin)); EVP_DigestFinal(&mdctx, md_value, &md_len); EVAL((*ppcdigest = (char *) realloc(*ppcdigest, md_len * sizeof(char) * 2 + sizeof('\0'))) == NULL, ERRDIGEST); strcpy(*ppcdigest, ""); for (u = 0; u < md_len; u++) { sprintf(ac, "%02x", *(md_value + u)); strcat(*ppcdigest, ac); } cleanup: return iret; }

void error (  int  i  )

Parses eserialerr and displays to browser wrapped in span. Parameters: i  eserialerr Definition at line 80 of file serializer.c. References PCCLOSE, and PCOPEN. { const char *apcerr[] = { "<span class=\"latexerror\">[phptex: ", ".]</span>" }; const char *apc[] = { "OK", "Internal error", "Digest error", "Error communicating with process", "Invalid directives", "Could not write LaTeX base", "Internal ImageMagick error", "ImageMagick read error", "ImageMagick pare error", "ImageMagick write error", "Error invoking `dvipng'", "dvipng functions not", "dvipng produced no output" }; printf("%s%s%s", apcerr[PCOPEN], apc[i], apcerr[PCCLOSE]); }

int serialize (  char *  pcin, pair_t *  ppa )

Creates hash digest of source and siphons either to specific or generic renderer. Parameters: pcin  renderand [sic] source ppa  parameter pairs, whose first is {class, content}; whose remaining: in-tag specificates Returns: status according to eserialerr . Definition at line 29 of file serializer.c. References serial_t::asen, digest(), serial_t::i, IEVAL, math(), NONE, pcdigest(), pairnode_t::pckey, serialnode_t::pf, ppa, and pair_t::ppan. Referenced by translate(). { int i, ierr, iret = EXIT_SUCCESS; const serial_t se = { CLASSES, { { "math", math } }}; char NONE(*pcdigest); IEVAL(digest(pcin, &pcdigest), ierr); for (i = 0; i < se.i; i++) { if (strcmp(ppa->ppan->pckey, (se.asen + i)->pc) == 0) { IEVAL((se.asen + i)->pf(pcin, pcdigest, ppa), ierr); goto cleanup; } } /* default case */ IEVAL(se.asen->pf(pcin, pcdigest, ppa), ierr); cleanup: free(pcdigest); return iret; }

Here is the call graph for this function:

---