cson  Hex Artifact Content

Artifact 87e6573e4f57cca6a1e0b890b8275ce0b1c438f0:

Wiki page [cson_cgi] by stephan 2011-05-09 17:58:44.
0000: 44 20 32 30 31 31 2d 30 35 2d 30 39 54 31 37 3a  D 2011-05-09T17:
0010: 35 38 3a 34 34 2e 32 32 36 0a 4c 20 63 73 6f 6e  58:44.226.L cson
0020: 5f 63 67 69 0a 50 20 38 65 30 35 32 66 61 64 31  _cgi.P 8e052fad1
0030: 63 61 37 35 35 66 64 63 34 36 32 33 38 34 65 37  ca755fdc462384e7
0040: 35 36 33 66 66 64 39 66 31 34 34 65 63 37 62 0a  563ffd9f144ec7b.
0050: 55 20 73 74 65 70 68 61 6e 0a 57 20 38 33 36 35  U stephan.W 8365
0060: 0a 3c 73 74 72 6f 6e 67 3e 41 43 48 54 55 4e 47  .<strong>ACHTUNG
0070: 3a 20 54 48 49 53 20 50 41 47 45 20 49 53 20 4e  : THIS PAGE IS N
0080: 4f 57 20 4d 41 49 4e 54 41 49 4e 45 44 20 49 4e  OW MAINTAINED IN
0090: 20 54 48 45 20 4e 45 57 20 57 49 4b 49 3a 3c 2f   THE NEW WIKI:</
00a0: 73 74 72 6f 6e 67 3e 20 5b 68 74 74 70 3a 2f 2f  strong> [http://
00b0: 77 68 69 6b 69 2e 77 61 6e 64 65 72 69 6e 67 68  whiki.wanderingh
00c0: 6f 72 73 65 2e 6e 65 74 2f 77 69 6b 69 73 2f 63  orse.net/wikis/c
00d0: 73 6f 6e 2f 3f 70 61 67 65 3d 63 73 6f 6e 5f 63  son/?page=cson_c
00e0: 67 69 5d 0a 0a 0a 53 65 65 20 61 6c 73 6f 3a 20  gi]...See also: 
00f0: 5b 63 73 6f 6e 5f 63 67 69 5f 48 6f 77 54 6f 5d  [cson_cgi_HowTo]
0100: 2c 20 5b 63 73 6f 6e 5f 73 65 73 73 69 6f 6e 5d  , [cson_session]
0110: 0d 0a 0d 0a 4f 6e 6c 69 6e 65 20 64 65 6d 6f 3a  ....Online demo:
0120: 20 5b 68 74 74 70 3a 2f 2f 66 6f 73 73 69 6c 2e   [http://fossil.
0130: 77 61 6e 64 65 72 69 6e 67 68 6f 72 73 65 2e 6e  wanderinghorse.n
0140: 65 74 2f 64 65 6d 6f 73 2f 63 73 6f 6e 2f 5d 0d  et/demos/cson/].
0150: 0a 0d 0a 3c 68 31 3e 63 73 6f 6e 5f 63 67 69 3c  ...<h1>cson_cgi<
0160: 2f 68 31 3e 0d 0a 0d 0a 3c 74 74 3e 63 73 6f 6e  /h1>....<tt>cson
0170: 5f 63 67 69 3c 2f 74 74 3e 20 69 73 20 61 6e 20  _cgi</tt> is an 
0180: 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 6d 69 6e  experimental min
0190: 69 2d 66 72 61 6d 65 77 6f 72 6b 2c 20 62 61 73  i-framework, bas
01a0: 65 64 20 6f 66 66 20 6f 66 20 3c 74 74 3e 63 73  ed off of <tt>cs
01b0: 6f 6e 3c 2f 74 74 3e 2c 20 66 6f 72 20 63 72 65  on</tt>, for cre
01c0: 61 74 69 6e 67 20 4a 53 4f 4e 2d 6f 6e 6c 79 20  ating JSON-only 
01d0: 5b 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70  [http://en.wikip
01e0: 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 43 6f  edia.org/wiki/Co
01f0: 6d 6d 6f 6e 5f 47 61 74 65 77 61 79 5f 49 6e 74  mmon_Gateway_Int
0200: 65 72 66 61 63 65 7c 43 47 49 20 77 65 62 20 61  erface|CGI web a
0210: 70 70 6c 69 63 61 74 69 6f 6e 73 5d 2e 20 54 68  pplications]. Th
0220: 65 20 6c 69 62 72 61 72 79 20 69 6d 70 6f 72 74  e library import
0230: 73 20 76 61 72 69 6f 75 73 20 43 47 49 2d 72 65  s various CGI-re
0240: 6c 61 74 65 64 20 64 61 74 61 20 28 65 2e 67 2e  lated data (e.g.
0250: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
0260: 69 61 62 6c 65 73 2c 20 47 45 54 2f 50 4f 53 54  iables, GET/POST
0270: 20 64 61 74 61 29 20 69 6e 74 6f 20 4a 53 4f 4e   data) into JSON
0280: 20 66 6f 72 6d 2c 20 6d 61 6b 65 73 20 69 74 20   form, makes it 
0290: 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 74 68 65  available to the
02a0: 20 63 6c 69 65 6e 74 20 61 70 70 6c 69 63 61 74   client applicat
02b0: 69 6f 6e 2c 20 61 6e 64 20 68 61 6e 64 6c 65 73  ion, and handles
02c0: 20 74 68 65 20 6f 75 74 70 75 74 20 6f 66 20 67   the output of g
02d0: 65 6e 65 72 61 74 65 64 20 4a 53 4f 4e 2e 20 43  enerated JSON. C
02e0: 6c 69 65 6e 74 20 61 70 70 6c 69 63 61 74 69 6f  lient applicatio
02f0: 6e 73 20 61 72 65 20 69 6e 74 65 6e 64 65 64 20  ns are intended 
0300: 74 6f 20 67 65 6e 65 72 61 74 65 20 6f 6e 6c 79  to generate only
0310: 20 4a 53 4f 4e 20 61 73 20 6f 75 74 70 75 74 2c   JSON as output,
0320: 20 61 6e 64 20 6e 65 65 64 20 6f 6e 6c 79 20 77   and need only w
0330: 6f 72 6b 20 77 69 74 68 20 68 69 67 68 2d 6c 65  ork with high-le
0340: 76 65 6c 20 3c 74 74 3e 63 73 6f 6e 3c 2f 74 74  vel <tt>cson</tt
0350: 3e 20 6f 62 6a 65 63 74 73 2e 20 54 68 69 73 20  > objects. This 
0360: 6c 69 62 72 61 72 79 20 68 61 6e 64 6c 65 73 20  library handles 
0370: 61 6c 6c 20 69 2f 6f 20 61 6e 64 20 70 61 72 73  all i/o and pars
0380: 69 6e 67 2e 0d 0a 0d 0a 49 74 20 69 73 20 70 72  ing.....It is pr
0390: 69 6d 61 72 69 6c 79 20 69 6e 74 65 6e 64 65 64  imarily intended
03a0: 20 66 6f 72 20 69 6d 70 6c 65 6d 65 6e 74 69 6e   for implementin
03b0: 67 20 4a 53 4f 4e 2d 63 65 6e 74 72 69 63 20 41  g JSON-centric A
03c0: 4a 41 58 2d 62 61 73 65 64 20 62 61 63 6b 2d 65  JAX-based back-e
03d0: 6e 64 73 2e 20 49 74 20 63 61 6e 20 61 6c 73 6f  nds. It can also
03e0: 20 62 65 20 75 73 65 64 20 66 6f 72 20 77 72 69   be used for wri
03f0: 74 69 6e 67 20 4a 53 4f 4e 2d 63 65 6e 74 72 69  ting JSON-centri
0400: 63 20 61 70 70 73 20 77 68 69 63 68 20 61 72 65  c apps which are
0410: 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79   not necessarily
0420: 20 43 47 49 2d 73 70 65 63 69 66 69 63 2e 20 54   CGI-specific. T
0430: 68 65 20 6c 69 62 72 61 72 79 20 69 74 73 65 6c  he library itsel
0440: 66 20 64 6f 65 73 20 6e 6f 74 20 3c 65 6d 3e 72  f does not <em>r
0450: 65 71 75 69 72 65 3c 2f 65 6d 3e 20 61 20 43 47  equire</em> a CG
0460: 49 2d 6c 69 6b 65 20 65 6e 76 69 72 6f 6e 6d 65  I-like environme
0470: 6e 74 20 74 6f 20 72 75 6e 2c 20 62 75 74 20 77  nt to run, but w
0480: 69 74 68 6f 75 74 20 43 47 49 2d 62 61 73 65 64  ithout CGI-based
0490: 20 69 6e 70 75 74 20 73 6f 6d 65 20 6f 66 20 69   input some of i
04a0: 74 73 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79  ts functionality
04b0: 20 77 69 6c 6c 20 62 65 20 6d 69 73 73 69 6e 67   will be missing
04c0: 20 28 65 2e 67 2e 2c 20 69 74 20 6f 62 76 69 6f   (e.g., it obvio
04d0: 75 73 6c 79 20 63 61 6e 6e 6f 74 20 6d 61 6e 61  usly cannot mana
04e0: 67 65 20 69 6e 62 6f 75 6e 64 20 48 54 54 50 20  ge inbound HTTP 
04f0: 50 4f 53 54 20 64 61 74 61 20 69 66 20 74 68 65  POST data if the
0500: 72 65 20 69 73 20 6e 6f 20 61 73 73 6f 63 69 61  re is no associa
0510: 74 65 64 20 50 4f 53 54 20 72 65 71 75 65 73 74  ted POST request
0520: 29 2e 0d 0a 0d 0a 63 73 6f 6e 5f 63 67 69 20 70  ).....cson_cgi p
0530: 72 6f 76 69 64 65 73 20 61 6e 20 65 61 73 79 2d  rovides an easy-
0540: 74 6f 2d 75 73 65 20 62 61 73 69 73 20 66 6f 72  to-use basis for
0550: 20 77 72 69 74 69 6e 67 20 43 47 49 20 61 70 70   writing CGI app
0560: 6c 69 63 61 74 69 6f 6e 73 20 77 68 69 63 68 20  lications which 
0570: 74 68 65 6d 73 65 6c 76 65 73 20 70 72 6f 64 75  themselves produ
0580: 63 65 20 3c 65 6d 3e 6f 6e 6c 79 3c 2f 65 6d 3e  ce <em>only</em>
0590: 20 4a 53 4f 4e 20 64 61 74 61 2e 20 49 74 20 69   JSON data. It i
05a0: 73 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 20 66  s not intended f
05b0: 6f 72 20 77 72 69 74 69 6e 67 20 48 54 4d 4c 2d  or writing HTML-
05c0: 67 65 6e 65 72 61 74 69 6e 67 20 43 47 49 73 2c  generating CGIs,
05d0: 20 61 6e 64 20 69 74 73 20 6f 75 74 70 75 74 20   and its output 
05e0: 6d 6f 64 65 6c 20 77 69 6c 6c 20 6e 6f 74 20 77  model will not w
05f0: 6f 72 6b 20 77 69 74 68 20 73 75 63 68 20 61 70  ork with such ap
0600: 70 6c 69 63 61 74 69 6f 6e 73 2e 20 54 68 61 74  plications. That
0610: 20 73 61 69 64 2c 20 69 74 20 63 61 6e 20 62 65   said, it can be
0620: 20 75 73 65 64 20 69 6e 20 63 6f 6e 6a 75 6e 63   used in conjunc
0630: 74 69 6f 6e 20 77 69 74 68 20 73 75 63 68 20 61  tion with such a
0640: 70 70 6c 69 63 61 74 69 6f 6e 73 20 61 73 20 6c  pplications as l
0650: 6f 6e 67 20 61 73 20 74 68 65 20 63 6c 69 65 6e  ong as the clien
0660: 74 20 74 61 6b 65 73 20 6f 76 65 72 20 74 68 65  t takes over the
0670: 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 61   generation of a
0680: 6c 6c 20 6f 75 74 70 75 74 20 28 62 75 74 20 74  ll output (but t
0690: 68 65 20 6c 69 62 72 61 72 79 20 63 61 6e 20 73  he library can s
06a0: 74 69 6c 6c 20 62 65 20 68 65 6c 70 66 75 6c 20  till be helpful 
06b0: 69 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 69 6e  in processing in
06c0: 63 6f 6d 69 6e 67 20 47 45 54 2f 50 4f 53 54 20  coming GET/POST 
06d0: 64 61 74 61 20 61 6e 64 20 70 72 6f 76 69 64 65  data and provide
06e0: 20 70 65 72 73 69 73 74 65 6e 74 20 73 65 73 73   persistent sess
06f0: 69 6f 6e 20 73 74 61 74 65 29 2e 0d 0a 0d 0a 3c  ion state).....<
0700: 73 74 72 6f 6e 67 3e 57 68 61 74 20 63 75 72 72  strong>What curr
0710: 65 6e 74 6c 79 20 77 6f 72 6b 73 3a 3c 2f 73 74  ently works:</st
0720: 72 6f 6e 67 3e 0d 0a 0d 0a 20 20 20 2a 20 20 4a  rong>....   *  J
0730: 53 4f 4e 2d 69 7a 65 73 20 74 68 65 20 48 54 54  SON-izes the HTT
0740: 50 20 47 45 54 20 70 61 72 61 6d 65 74 65 72 73  P GET parameters
0750: 2c 20 63 6f 6f 6b 69 65 73 2c 20 74 68 65 20 73  , cookies, the s
0760: 79 73 74 65 6d 20 65 6e 76 69 72 6f 6e 6d 65 6e  ystem environmen
0770: 74 20 76 61 72 69 61 62 6c 65 73 2c 20 61 6e 64  t variables, and
0780: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 61 72   command-line ar
0790: 67 75 6d 65 6e 74 73 2e 0d 0a 20 20 20 2a 20 20  guments...   *  
07a0: 52 65 61 64 73 20 4a 53 4f 4e 2d 66 6f 72 6d 61  Reads JSON-forma
07b0: 74 20 28 75 6e 65 6e 63 6f 64 65 64 29 20 6f 72  t (unencoded) or
07c0: 20 66 6f 72 6d 2d 75 72 6c 65 6e 63 6f 64 65 64   form-urlencoded
07d0: 20 48 54 54 50 20 50 4f 53 54 20 64 61 74 61 2e   HTTP POST data.
07e0: 0d 0a 20 20 20 2a 20 20 4d 61 6b 65 73 20 74 68  ..   *  Makes th
07f0: 65 20 61 62 6f 76 65 20 64 61 74 61 20 61 76 61  e above data ava
0800: 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 61 70  ilable to the ap
0810: 70 6c 69 63 61 74 69 6f 6e 20 69 6e 20 74 68 65  plication in the
0820: 20 66 6f 72 6d 20 6f 66 20 4a 53 4f 4e 20 6f 62   form of JSON ob
0830: 6a 65 63 74 20 74 72 65 65 73 20 28 75 73 69 6e  ject trees (usin
0840: 67 20 74 68 65 20 63 73 6f 6e 20 41 50 49 29 2e  g the cson API).
0850: 0d 0a 20 20 20 2a 20 20 41 6c 6c 6f 77 73 20 63  ..   *  Allows c
0860: 6c 69 65 6e 74 73 20 74 6f 20 61 64 64 20 63 75  lients to add cu
0870: 73 74 6f 6d 20 48 54 54 50 20 68 65 61 64 65 72  stom HTTP header
0880: 73 20 61 6e 64 20 63 6f 6f 6b 69 65 73 2e 0d 0a  s and cookies...
0890: 20 20 20 2a 20 20 48 61 6e 64 6c 65 73 20 61 6c     *  Handles al
08a0: 6c 20 69 2f 6f 20 66 6f 72 20 74 68 65 20 63 6c  l i/o for the cl
08b0: 69 65 6e 74 2c 20 62 6f 74 68 20 69 6e 70 75 74  ient, both input
08c0: 20 61 6e 64 20 6f 75 74 70 75 74 2e 20 28 43 6c   and output. (Cl
08d0: 69 65 6e 74 20 43 47 49 20 61 70 70 6c 69 63 61  ient CGI applica
08e0: 74 69 6f 6e 73 20 3c 65 6d 3e 6d 75 73 74 20 6e  tions <em>must n
08f0: 6f 74 3c 2f 65 6d 3e 20 67 65 6e 65 72 61 74 65  ot</em> generate
0900: 20 61 6e 79 20 6f 75 74 70 75 74 20 74 6f 20 73   any output to s
0910: 74 64 6f 75 74 2c 20 6f 72 20 74 68 65 79 20 72  tdout, or they r
0920: 69 73 6b 20 69 6e 76 61 6c 69 64 61 74 69 6e 67  isk invalidating
0930: 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20 6f   the generated o
0940: 75 74 70 75 74 2e 29 0d 0a 20 20 20 2a 20 20 43  utput.)..   *  C
0950: 6c 69 65 6e 74 2d 63 6f 6e 66 69 67 75 72 61 62  lient-configurab
0960: 6c 65 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 6f  le indentation o
0970: 66 20 67 65 6e 65 72 61 74 65 64 20 4a 53 4f 4e  f generated JSON
0980: 2c 20 77 69 74 68 20 76 61 72 69 6f 75 73 20 74  , with various t
0990: 72 61 64 65 6f 66 66 73 20 61 76 61 69 6c 61 62  radeoffs availab
09a0: 6c 65 20 66 6f 72 20 68 75 6d 61 6e 2d 72 65 61  le for human-rea
09b0: 64 61 62 69 6c 69 74 79 20 76 73 2e 20 73 6d 61  dability vs. sma
09c0: 6c 6c 20 6f 75 74 70 75 74 20 73 69 7a 65 2e 0d  ll output size..
09d0: 0a 20 20 20 2a 20 20 4f 70 74 69 6f 6e 61 6c 20  .   *  Optional 
09e0: 5b 63 73 6f 6e 5f 73 65 73 73 69 6f 6e 7c 73 65  [cson_session|se
09f0: 73 73 69 6f 6e 20 73 75 70 70 6f 72 74 5d 2c 20  ssion support], 
0a00: 69 6e 20 74 68 65 20 66 6f 72 6d 20 6f 66 20 61  in the form of a
0a10: 20 70 65 72 73 69 73 74 65 6e 74 20 4a 53 4f 4e   persistent JSON
0a20: 20 6f 62 6a 65 63 74 20 74 72 65 65 2e 20 53 75   object tree. Su
0a30: 70 70 6f 72 74 73 20 73 74 6f 72 69 6e 67 20 73  pports storing s
0a40: 65 73 73 69 6f 6e 73 20 69 6e 20 66 69 6c 65 73  essions in files
0a50: 20 6f 72 20 69 6e 20 61 20 73 71 6c 69 74 65 33   or in a sqlite3
0a60: 2f 6d 79 73 71 6c 35 20 64 61 74 61 62 61 73 65  /mysql5 database
0a70: 20 28 75 73 69 6e 67 20 5b 68 74 74 70 3a 2f 2f   (using [http://
0a80: 66 6f 73 73 69 6c 2e 77 61 6e 64 65 72 69 6e 67  fossil.wandering
0a90: 68 6f 72 73 65 2e 6e 65 74 2f 72 65 70 6f 73 2f  horse.net/repos/
0aa0: 63 70 64 6f 2f 7c 6c 69 62 63 70 64 6f 5d 2c 20  cpdo/|libcpdo], 
0ab0: 77 68 69 63 68 20 69 73 20 69 6e 63 6c 75 64 65  which is include
0ac0: 64 20 69 6e 20 74 68 69 73 20 73 6f 75 72 63 65  d in this source
0ad0: 20 74 72 65 65 20 61 6e 64 20 64 6f 65 73 20 6e   tree and does n
0ae0: 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 69 6e  ot need to be in
0af0: 73 74 61 6c 6c 65 64 20 65 78 74 72 61 20 62 79  stalled extra by
0b00: 20 74 68 65 20 63 6c 69 65 6e 74 29 2e 20 54 68   the client). Th
0b10: 65 20 73 65 73 73 69 6f 6e 20 49 44 20 63 6f 6d  e session ID com
0b20: 65 73 20 66 72 6f 6d 20 61 6e 20 48 54 54 50 20  es from an HTTP 
0b30: 63 6f 6f 6b 69 65 20 62 79 20 64 65 66 61 75 6c  cookie by defaul
0b40: 74 2c 20 62 75 74 20 63 6c 69 65 6e 74 20 63 6f  t, but client co
0b50: 64 65 20 63 61 6e 20 61 6c 73 6f 20 73 70 65 63  de can also spec
0b60: 69 66 79 20 74 68 65 69 72 20 6f 77 6e 20 69 66  ify their own if
0b70: 20 74 68 65 79 20 6c 69 6b 65 2e 20 28 69 27 6d   they like. (i'm
0b80: 20 6e 6f 74 20 61 77 61 72 65 20 6f 66 20 61 6e   not aware of an
0b90: 79 20 6f 74 68 65 72 20 43 47 49 20 66 72 61 6d  y other CGI fram
0ba0: 65 77 6f 72 6b 20 3c 65 6d 3e 69 6d 70 6c 65 6d  ework <em>implem
0bb0: 65 6e 74 65 64 20 69 6e 20 43 2f 43 2b 2b 3c 2f  ented in C/C++</
0bc0: 65 6d 3e 20 77 68 69 63 68 20 73 75 70 70 6f 72  em> which suppor
0bd0: 74 73 20 70 65 72 73 69 73 74 65 6e 74 20 73 65  ts persistent se
0be0: 73 73 69 6f 6e 73 2e 29 0d 0a 0d 0a 3c 73 74 72  ssions.)....<str
0bf0: 6f 6e 67 3e 4e 6f 74 61 62 6c 65 20 54 4f 44 4f  ong>Notable TODO
0c00: 73 2e 2e 2e 3c 2f 73 74 72 6f 6e 67 3e 0d 0a 0d  s...</strong>...
0c10: 0a 20 20 20 2a 20 20 53 75 70 70 6f 72 74 20 4a  .   *  Support J
0c20: 53 4f 4e 20 6f 62 6a 65 63 74 73 2f 61 72 72 61  SON objects/arra
0c30: 79 73 20 61 73 20 63 6f 6f 6b 69 65 20 76 61 6c  ys as cookie val
0c40: 75 65 73 2c 20 62 79 20 4a 53 4f 4e 69 6e 67 20  ues, by JSONing 
0c50: 74 68 65 6d 20 61 6e 64 20 74 68 65 6e 20 75 72  them and then ur
0c60: 6c 65 6e 63 6f 64 69 6e 67 20 74 68 65 6d 2e 20  lencoding them. 
0c70: 43 75 72 72 65 6e 74 6c 79 20 6f 6e 6c 79 20 22  Currently only "
0c80: 70 6c 61 69 6e 22 20 74 79 70 65 73 20 28 6e 75  plain" types (nu
0c90: 6d 62 65 72 73 2c 20 73 74 72 69 6e 67 73 2c 20  mbers, strings, 
0ca0: 62 6f 6f 6c 65 61 6e 2c 20 6e 75 6c 6c 29 20 61  boolean, null) a
0cb0: 72 65 20 61 6c 6c 6f 77 65 64 20 61 73 20 63 6f  re allowed as co
0cc0: 6f 6b 69 65 20 76 61 6c 75 65 73 2e 0d 0a 20 20  okie values...  
0cd0: 20 2a 20 20 4a 53 4f 4e 50 20 73 75 70 70 6f 72   *  JSONP suppor
0ce0: 74 2e 0d 0a 20 20 20 2a 20 20 4d 6f 72 65 20 64  t...   *  More d
0cf0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 45 73  ocumentation. Es
0d00: 70 65 63 69 61 6c 6c 79 20 64 6f 63 75 6d 65 6e  pecially documen
0d10: 74 20 68 6f 77 20 74 6f 20 65 6e 61 62 6c 65 20  t how to enable 
0d20: 65 61 63 68 20 73 65 70 61 72 61 74 65 20 44 42  each separate DB
0d30: 20 64 72 69 76 65 72 20 69 6d 70 6c 65 6d 65 6e   driver implemen
0d40: 74 61 74 69 6f 6e 2c 20 61 6e 64 20 74 68 65 20  tation, and the 
0d50: 6c 69 6e 6b 69 6e 67 20 61 72 67 75 6d 65 6e 74  linking argument
0d60: 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 65  s required for e
0d70: 61 63 68 2e 0d 0a 20 20 20 2a 20 20 43 75 72 72  ach...   *  Curr
0d80: 65 6e 74 6c 79 20 72 65 71 75 69 72 65 73 20 74  ently requires t
0d90: 68 61 74 20 63 65 72 74 61 69 6e 20 4a 53 4f 4e  hat certain JSON
0da0: 20 64 61 74 61 20 62 65 20 4f 62 6a 65 63 74 73   data be Objects
0db0: 2c 20 61 73 20 6f 70 70 6f 73 65 64 20 74 6f 20  , as opposed to 
0dc0: 41 72 72 61 79 73 2e 20 54 68 69 73 20 69 73 20  Arrays. This is 
0dd0: 6f 6e 20 74 68 65 20 74 6f 2d 66 69 78 20 6c 69  on the to-fix li
0de0: 73 74 2c 20 62 75 74 20 69 6e 20 6d 79 20 65 78  st, but in my ex
0df0: 70 65 72 69 65 6e 63 65 20 61 72 72 61 79 73 20  perience arrays 
0e00: 61 72 65 20 73 65 6c 64 6f 6d 20 75 73 65 64 20  are seldom used 
0e10: 61 73 20 4a 53 4f 4e 20 72 6f 6f 74 20 6e 6f 64  as JSON root nod
0e20: 65 73 2e 0d 0a 20 20 20 2a 20 20 4f 6e 65 20 69  es...   *  One i
0e30: 6e 74 65 72 6e 61 6c 6c 79 2d 75 73 65 64 20 66  nternally-used f
0e40: 75 6e 63 74 69 6f 6e 20 72 65 71 75 69 72 65 73  unction requires
0e50: 20 43 39 39 20 63 6f 6d 70 69 6c 61 74 69 6f 6e   C99 compilation
0e60: 20 6d 6f 64 65 2e 20 54 68 69 73 20 73 68 6f 75   mode. This shou
0e70: 6c 64 20 62 65 20 72 65 77 72 69 74 74 65 6e 20  ld be rewritten 
0e80: 74 6f 20 77 6f 72 6b 20 69 6e 20 43 38 39 2c 20  to work in C89, 
0e90: 61 73 20 69 74 20 69 73 20 74 68 65 20 6f 6e 6c  as it is the onl
0ea0: 79 20 63 6f 64 65 20 69 6e 20 74 68 65 20 74 72  y code in the tr
0eb0: 65 65 20 77 68 69 63 68 20 6e 65 65 64 73 20 43  ee which needs C
0ec0: 39 39 2e 0d 0a 20 20 20 2a 20 20 54 68 65 20 63  99...   *  The c
0ed0: 6f 6f 6b 69 65 20 6f 75 74 70 75 74 20 72 6f 75  ookie output rou
0ee0: 74 69 6e 65 20 68 61 73 20 73 6f 6d 65 20 67 6c  tine has some gl
0ef0: 61 72 69 6e 67 20 62 75 66 66 65 72 20 6f 76 65  aring buffer ove
0f00: 72 72 75 6e 20 70 6f 73 73 69 62 69 6c 69 74 69  rrun possibiliti
0f10: 65 73 2e 0d 0a 0d 0a 3c 73 74 72 6f 6e 67 3e 4c  es.....<strong>L
0f20: 65 73 73 20 73 69 67 6e 69 66 69 63 61 6e 74 20  ess significant 
0f30: 54 4f 44 4f 73 2e 2e 2e 3c 2f 73 74 72 6f 6e 67  TODOs...</strong
0f40: 3e 0d 0a 0d 0a 20 20 20 2a 20 20 41 6c 6c 6f 77  >....   *  Allow
0f50: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69   configuration i
0f60: 6e 66 6f 20 74 6f 20 63 6f 6d 65 20 66 72 6f 6d  nfo to come from
0f70: 20 61 20 4a 53 4f 4e 20 6f 62 6a 65 63 74 20 74   a JSON object t
0f80: 72 65 65 2c 20 69 6e 73 74 65 61 64 20 6f 66 20  ree, instead of 
0f90: 6a 75 73 74 20 66 72 6f 6d 20 61 6e 20 69 6e 70  just from an inp
0fa0: 75 74 20 66 69 6c 65 2e 20 54 68 69 73 20 77 6f  ut file. This wo
0fb0: 75 6c 64 20 61 6c 6c 6f 77 2c 20 65 2e 67 2e 2c  uld allow, e.g.,
0fc0: 20 74 68 65 20 63 6c 69 65 6e 74 20 74 6f 20 73   the client to s
0fd0: 74 6f 72 65 20 68 69 73 20 63 73 6f 6e 5f 63 67  tore his cson_cg
0fe0: 69 20 63 6f 6e 66 69 67 20 65 6d 62 65 64 64 65  i config embedde
0ff0: 64 20 69 6e 20 61 6e 6f 74 68 65 72 20 63 6c 69  d in another cli
1000: 65 6e 74 2d 64 65 66 69 6e 65 64 20 4a 53 4f 4e  ent-defined JSON
1010: 2d 66 6f 72 6d 61 74 20 63 6f 6e 66 69 67 75 72  -format configur
1020: 61 74 69 6f 6e 20 66 69 6c 65 2f 6f 62 6a 65 63  ation file/objec
1030: 74 2c 20 61 6e 64 20 74 68 65 6e 20 66 65 65 64  t, and then feed
1040: 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65   the appropriate
1050: 20 73 75 62 74 72 65 65 20 74 6f 20 3c 74 74 3e   subtree to <tt>
1060: 63 73 6f 6e 5f 63 67 69 5f 69 6e 69 74 28 29 3c  cson_cgi_init()<
1070: 2f 74 74 3e 2e 0d 0a 20 20 20 2a 20 20 50 6f 73  /tt>...   *  Pos
1080: 73 69 62 6c 79 20 6d 6f 76 65 20 74 68 65 20 73  sibly move the s
1090: 65 73 73 69 6f 6e 20 69 6e 69 74 69 61 6c 69 7a  ession initializ
10a0: 61 74 69 6f 6e 20 73 74 65 70 20 6f 75 74 20 6f  ation step out o
10b0: 66 20 3c 74 74 3e 63 73 6f 6e 5f 63 67 69 5f 69  f <tt>cson_cgi_i
10c0: 6e 69 74 28 29 3c 2f 74 74 3e 2c 20 73 6f 20 74  nit()</tt>, so t
10d0: 68 61 74 20 74 68 65 20 63 6c 69 65 6e 74 20 63  hat the client c
10e0: 61 6e 20 73 74 61 72 74 20 74 68 65 20 73 65 73  an start the ses
10f0: 73 69 6f 6e 20 6d 61 6e 75 61 6c 6c 79 20 62 61  sion manually ba
1100: 73 65 64 20 6f 6e 20 63 6f 6e 66 69 67 20 69 6e  sed on config in
1110: 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65  formation in the
1120: 20 72 65 71 75 65 73 74 2f 65 6e 76 69 72 6f 6e   request/environ
1130: 6d 65 6e 74 20 73 74 61 74 65 2e 20 43 75 72 72  ment state. Curr
1140: 65 6e 74 6c 79 20 74 68 65 20 73 65 73 73 69 6f  ently the sessio
1150: 6e 20 69 73 20 73 74 61 72 74 65 64 20 69 66 20  n is started if 
1160: 69 74 20 63 61 6e 20 62 65 20 28 69 66 20 69 74  it can be (if it
1170: 27 73 20 74 75 72 6e 65 64 20 6f 6e 20 61 6e 64  's turned on and
1180: 20 70 72 6f 70 65 72 6c 79 20 63 6f 6e 66 69 67   properly config
1190: 75 72 65 64 20 69 6e 20 74 68 65 20 63 6f 6e 66  ured in the conf
11a0: 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 29 2c  iguration file),
11b0: 20 62 75 74 20 70 72 6f 76 69 64 65 73 20 6e 6f   but provides no
11c0: 20 77 61 79 20 74 6f 20 73 65 74 20 69 74 20 75   way to set it u
11d0: 70 20 61 66 74 65 72 2d 74 68 65 2d 66 61 63 74  p after-the-fact
11e0: 20 69 66 20 74 68 65 20 64 65 66 61 75 6c 74 20   if the default 
11f0: 62 65 68 61 76 69 6f 75 72 20 63 61 6e 6e 6f 74  behaviour cannot
1200: 20 73 74 61 72 74 20 74 68 65 20 73 65 73 73 69   start the sessi
1210: 6f 6e 2e 0d 0a 20 20 20 2a 20 20 41 64 64 20 61  on...   *  Add a
1220: 6e 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e  n initialization
1230: 20 6f 70 74 69 6f 6e 20 74 6f 20 64 69 73 61 62   option to disab
1240: 6c 65 20 61 75 74 6f 6d 61 74 69 63 20 68 61 6e  le automatic han
1250: 64 6c 69 6e 67 20 6f 66 20 50 4f 53 54 20 64 61  dling of POST da
1260: 74 61 2c 20 73 6f 20 74 68 61 74 20 74 68 65 20  ta, so that the 
1270: 63 6c 69 65 6e 74 20 63 61 6e 20 72 65 61 64 20  client can read 
1280: 69 74 20 74 68 65 6d 73 65 6c 76 65 73 2e 20 57  it themselves. W
1290: 65 20 63 75 72 72 65 6e 74 6c 79 20 61 75 74 6f  e currently auto
12a0: 6d 61 74 69 63 61 6c 6c 79 20 63 6f 6e 73 75 6d  matically consum
12b0: 65 20 74 68 65 20 73 74 64 69 6e 20 69 6e 70 75  e the stdin inpu
12c0: 74 20 6f 6e 6c 79 20 69 66 20 74 68 65 20 3c 74  t only if the <t
12d0: 74 3e 43 4f 4e 54 45 4e 54 5f 54 59 50 45 3c 2f  t>CONTENT_TYPE</
12e0: 74 74 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  tt> environment 
12f0: 76 61 72 69 61 62 6c 65 20 28 77 68 69 63 68 20  variable (which 
1300: 67 65 74 73 20 73 65 74 20 62 79 20 74 68 65 20  gets set by the 
1310: 77 65 62 20 73 65 72 76 65 72 29 20 63 6f 6e 74  web server) cont
1320: 61 69 6e 73 20 61 20 74 79 70 65 20 77 68 69 63  ains a type whic
1330: 68 20 77 65 20 63 61 6e 20 70 6f 73 73 69 62 6c  h we can possibl
1340: 79 20 69 6e 74 65 72 70 72 65 74 20 61 73 20 72  y interpret as r
1350: 61 77 20 4a 53 4f 4e 20 28 6e 61 6d 65 6c 79 20  aw JSON (namely 
1360: 74 68 65 20 74 79 70 65 73 20 3c 74 74 3e 61 70  the types <tt>ap
1370: 70 6c 69 63 61 74 69 6f 6e 2f 6a 73 6f 6e 3c 2f  plication/json</
1380: 74 74 3e 20 61 6e 64 20 3c 74 74 3e 74 65 78 74  tt> and <tt>text
1390: 2f 70 6c 61 69 6e 3c 2f 74 74 3e 29 20 6f 72 20  /plain</tt>) or 
13a0: 64 65 63 6f 64 65 20 28 66 6f 72 6d 2d 75 72 6c  decode (form-url
13b0: 65 6e 63 6f 64 65 64 29 2e 0d 0a 20 20 20 2a 20  encoded)...   * 
13c0: 20 41 64 64 20 61 6e 20 6f 70 74 69 6f 6e 20 74   Add an option t
13d0: 6f 20 61 6c 6c 6f 77 20 74 68 65 20 63 6c 69 65  o allow the clie
13e0: 6e 74 20 61 70 70 20 28 6e 6f 74 20 74 68 65 20  nt app (not the 
13f0: 72 65 6d 6f 74 65 20 63 6c 69 65 6e 74 29 20 74  remote client) t
1400: 6f 20 66 6f 72 63 65 20 61 20 73 70 65 63 69 66  o force a specif
1410: 69 63 20 63 6f 6e 74 65 6e 74 20 74 79 70 65 20  ic content type 
1420: 73 74 72 69 6e 67 20 66 6f 72 20 74 68 65 20 6f  string for the o
1430: 75 74 70 75 74 2e 20 69 27 76 65 20 73 65 65 6e  utput. i've seen
1440: 20 63 61 73 65 73 20 6f 66 20 46 69 72 65 66 6f   cases of Firefo
1450: 78 20 6e 6f 74 20 61 63 63 65 70 74 69 6e 67 20  x not accepting 
1460: 3c 74 74 3e 61 70 70 6c 69 63 61 74 69 6f 6e 2f  <tt>application/
1470: 6a 73 6f 6e 3c 2f 74 74 3e 20 61 73 20 74 65 78  json</tt> as tex
1480: 74 2c 20 69 6e 73 74 65 61 64 20 64 6f 77 6e 6c  t, instead downl
1490: 6f 61 64 69 6e 67 20 69 74 20 74 6f 20 61 20 6c  oading it to a l
14a0: 6f 63 61 6c 20 66 69 6c 65 2e 20 43 75 72 72 65  ocal file. Curre
14b0: 6e 74 6c 79 20 77 65 20 74 72 79 20 74 6f 20 67  ntly we try to g
14c0: 75 65 73 73 20 74 68 65 20 6f 75 74 2d 62 6f 75  uess the out-bou
14d0: 6e 64 20 63 6f 6e 74 65 6e 74 20 74 79 70 65 20  nd content type 
14e0: 73 74 72 69 6e 67 20 62 61 73 65 64 20 6f 6e 20  string based on 
14f0: 74 68 65 20 3c 74 74 3e 48 54 54 50 5f 41 43 43  the <tt>HTTP_ACC
1500: 45 50 54 3c 2f 74 74 3e 20 76 61 6c 75 65 73 2c  EPT</tt> values,
1510: 20 66 61 6c 6c 69 6e 67 20 62 61 63 6b 20 74 6f   falling back to
1520: 20 3c 74 74 3e 74 65 78 74 2f 70 6c 61 69 6e 3c   <tt>text/plain<
1530: 2f 74 74 3e 20 69 66 20 74 68 65 20 75 73 65 72  /tt> if the user
1540: 20 61 67 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20   agent does not 
1550: 72 65 70 6f 72 74 20 73 75 70 70 6f 72 74 69 6e  report supportin
1560: 67 20 3c 74 74 3e 61 70 70 6c 69 63 61 74 69 6f  g <tt>applicatio
1570: 6e 2f 6a 73 6f 6e 3c 2f 74 74 3e 2e 0d 0a 20 20  n/json</tt>...  
1580: 20 2a 20 20 41 64 64 20 61 20 73 65 73 73 69 6f   *  Add a sessio
1590: 6e 20 6d 61 6e 61 67 65 72 20 69 6d 70 6c 20 77  n manager impl w
15a0: 68 69 63 68 20 6c 6f 61 64 73 2f 73 74 6f 72 65  hich loads/store
15b0: 73 20 69 74 73 20 73 74 61 74 65 20 66 72 6f 6d  s its state from
15c0: 2f 74 6f 20 61 20 63 6f 6f 6b 69 65 2e 20 54 68  /to a cookie. Th
15d0: 69 73 20 63 61 6e 20 6f 6e 6c 79 20 77 6f 72 6b  is can only work
15e0: 20 69 66 20 74 68 65 20 73 65 73 73 69 6f 6e 20   if the session 
15f0: 73 74 61 79 73 20 72 65 61 6c 6c 79 20 73 6d 61  stays really sma
1600: 6c 6c 2c 20 62 75 74 20 6d 69 67 68 74 20 68 61  ll, but might ha
1610: 76 65 20 73 6f 6d 65 20 69 6e 74 65 72 65 73 74  ve some interest
1620: 69 6e 67 20 75 73 65 73 2e 20 54 68 69 73 20 73  ing uses. This s
1630: 75 70 70 6f 72 74 20 64 65 70 65 6e 64 73 20 6f  upport depends o
1640: 6e 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f  n the ability to
1650: 20 63 6f 6f 6b 69 65 2d 73 65 72 69 61 6c 69 7a   cookie-serializ
1660: 65 2f 64 65 73 65 72 69 61 6c 69 7a 65 20 6f 62  e/deserialize ob
1670: 6a 65 63 74 73 2f 61 72 72 61 79 73 2c 20 77 68  jects/arrays, wh
1680: 69 63 68 20 69 73 20 6f 6e 20 74 68 65 20 54 4f  ich is on the TO
1690: 44 4f 20 6c 69 73 74 20 28 77 65 20 68 61 76 65  DO list (we have
16a0: 20 61 6c 6c 20 74 68 65 20 63 6f 64 65 2c 20 77   all the code, w
16b0: 65 20 6a 75 73 74 20 6e 65 65 64 20 74 6f 20 67  e just need to g
16c0: 6c 75 65 20 69 74 20 74 6f 67 65 74 68 65 72 29  lue it together)
16d0: 2e 0d 0a 0d 0a 3c 73 74 72 6f 6e 67 3e 54 68 69  .....<strong>Thi
16e0: 6e 67 73 20 69 74 20 77 6f 6e 27 74 20 65 76 65  ngs it won't eve
16f0: 72 20 64 6f 2e 2e 2e 3c 2f 73 74 72 6f 6e 67 3e  r do...</strong>
1700: 0d 0a 0d 0a 20 20 20 2a 20 20 48 61 6e 64 6c 65  ....   *  Handle
1710: 20 66 69 6c 65 20 75 70 6c 6f 61 64 73 2e 20 49   file uploads. I
1720: 66 20 74 68 65 20 64 61 74 61 20 63 61 6e 27 74  f the data can't
1730: 20 66 69 74 20 69 6e 20 4a 53 4f 4e 20 74 68 65   fit in JSON the
1740: 6e 20 69 74 20 77 6f 6e 27 74 20 62 65 20 68 61  n it won't be ha
1750: 6e 64 6c 65 64 20 68 65 72 65 2e 0d 0a 0d 0a 3c  ndled here.....<
1760: 68 31 3e 53 61 6d 70 6c 65 20 6f 75 74 70 75 74  h1>Sample output
1770: 3c 2f 68 31 3e 0d 0a 0d 0a 48 65 72 65 27 73 20  </h1>....Here's 
1780: 73 6f 6d 65 20 73 61 6d 70 6c 65 20 63 6c 69 65  some sample clie
1790: 6e 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 6f  nt application o
17a0: 75 74 70 75 74 2e 20 54 68 69 73 20 61 70 70 20  utput. This app 
17b0: 73 69 6d 70 6c 79 20 72 65 74 75 72 6e 73 20 73  simply returns s
17c0: 6f 6d 65 20 6f 66 20 74 68 65 20 76 61 72 69 6f  ome of the vario
17d0: 75 73 20 3c 74 74 3e 63 73 6f 6e 5f 63 67 69 3c  us <tt>cson_cgi<
17e0: 2f 74 74 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74  /tt> environment
17f0: 20 64 61 74 61 20 74 6f 20 74 68 65 20 75 73 65   data to the use
1800: 72 2e 2e 2e 0d 0a 0d 0a 3c 76 65 72 62 61 74 69  r.......<verbati
1810: 6d 3e 0d 0a 7b 0d 0a 20 20 20 20 22 61 72 67 76  m>..{..    "argv
1820: 22 3a 20 5b 0d 0a 20 20 20 20 20 20 20 20 22 2e  ": [..        ".
1830: 2f 63 67 69 2d 74 65 73 74 22 2c 0d 0a 20 20 20  /cgi-test",..   
1840: 20 20 20 20 20 22 2d 61 3d 62 22 2c 0d 0a 20 20       "-a=b",..  
1850: 20 20 20 20 20 20 22 63 22 2c 0d 0a 20 20 20 20        "c",..    
1860: 20 20 20 20 22 31 32 33 22 0d 0a 20 20 20 20 5d      "123"..    ]
1870: 2c 0d 0a 20 20 20 20 22 24 45 4e 56 22 3a 20 7b  ,..    "$ENV": {
1880: 0d 0a 20 20 20 20 20 20 20 20 22 47 41 54 45 57  ..        "GATEW
1890: 41 59 5f 49 4e 54 45 52 46 41 43 45 22 3a 20 22  AY_INTERFACE": "
18a0: 43 47 49 2f 31 2e 31 22 2c 0d 0a 20 20 20 20 20  CGI/1.1",..     
18b0: 20 20 20 22 43 4f 4e 54 45 4e 54 5f 54 59 50 45     "CONTENT_TYPE
18c0: 22 3a 20 22 61 70 70 6c 69 63 61 74 69 6f 6e 2f  ": "application/
18d0: 6a 73 6f 6e 22 2c 0d 0a 20 20 20 20 20 20 20 20  json",..        
18e0: 22 48 54 54 50 5f 41 43 43 45 50 54 5f 43 48 41  "HTTP_ACCEPT_CHA
18f0: 52 53 45 54 22 3a 20 22 49 53 4f 2d 38 38 35 39  RSET": "ISO-8859
1900: 2d 31 2c 75 74 66 2d 38 3b 71 3d 30 2e 37 2c 2a  -1,utf-8;q=0.7,*
1910: 3b 71 3d 30 2e 33 22 2c 0d 0a 20 20 20 20 20 20  ;q=0.3",..      
1920: 20 20 22 48 54 54 50 5f 58 5f 52 45 51 55 45 53    "HTTP_X_REQUES
1930: 54 45 44 5f 57 49 54 48 22 3a 20 22 58 4d 4c 48  TED_WITH": "XMLH
1940: 74 74 70 52 65 71 75 65 73 74 22 2c 0d 0a 20 20  ttpRequest",..  
1950: 20 20 20 20 20 20 22 52 45 4d 4f 54 45 5f 41 44        "REMOTE_AD
1960: 44 52 22 3a 20 22 31 32 37 2e 31 2e 31 2e 31 22  DR": "127.1.1.1"
1970: 2c 0d 0a 20 20 20 20 20 20 20 20 22 51 55 45 52  ,..        "QUER
1980: 59 5f 53 54 52 49 4e 47 22 3a 20 22 61 5b 5d 3d  Y_STRING": "a[]=
1990: 33 26 61 5b 5d 3d 37 22 2c 0d 0a 20 20 20 20 20  3&a[]=7",..     
19a0: 20 20 20 22 52 45 4d 4f 54 45 5f 50 4f 52 54 22     "REMOTE_PORT"
19b0: 3a 20 22 34 33 34 32 32 22 2c 0d 0a 20 20 20 20  : "43422",..    
19c0: 20 20 20 20 22 44 4f 43 55 4d 45 4e 54 5f 52 4f      "DOCUMENT_RO
19d0: 4f 54 22 3a 20 22 2f 68 6f 6d 65 2f 73 74 65 70  OT": "/home/step
19e0: 68 61 6e 2f 63 76 73 2f 66 6f 73 73 69 6c 2f 63  han/cvs/fossil/c
19f0: 73 6f 6e 22 2c 0d 0a 20 20 20 20 20 20 20 20 22  son",..        "
1a00: 48 54 54 50 5f 55 53 45 52 5f 41 47 45 4e 54 22  HTTP_USER_AGENT"
1a10: 3a 20 22 4d 6f 7a 69 6c 6c 61 2f 35 2e 30 20 28  : "Mozilla/5.0 (
1a20: 58 31 31 3b 20 4c 69 6e 75 78 20 78 38 36 5f 36  X11; Linux x86_6
1a30: 34 29 20 41 70 70 6c 65 57 65 62 4b 69 74 2f 35  4) AppleWebKit/5
1a40: 33 34 2e 32 38 20 28 4b 48 54 4d 4c 2c 20 6c 69  34.28 (KHTML, li
1a50: 6b 65 20 47 65 63 6b 6f 29 20 43 68 72 6f 6d 65  ke Gecko) Chrome
1a60: 2f 31 32 2e 30 2e 37 32 35 2e 30 20 53 61 66 61  /12.0.725.0 Safa
1a70: 72 69 2f 35 33 34 2e 32 38 22 2c 0d 0a 20 20 20  ri/534.28",..   
1a80: 20 20 20 20 20 22 53 45 52 56 45 52 5f 53 49 47       "SERVER_SIG
1a90: 4e 41 54 55 52 45 22 3a 20 22 3c 61 64 64 72 65  NATURE": "<addre
1aa0: 73 73 3e 41 70 61 63 68 65 2f 32 2e 32 2e 31 36  ss>Apache/2.2.16
1ab0: 20 28 55 62 75 6e 74 75 29 20 53 65 72 76 65 72   (Ubuntu) Server
1ac0: 20 61 74 20 63 73 6f 6e 2d 63 67 69 20 50 6f 72   at cson-cgi Por
1ad0: 74 20 38 30 3c 2f 61 64 64 72 65 73 73 3e 5c 6e  t 80</address>\n
1ae0: 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 48 54 54  ",..        "HTT
1af0: 50 5f 41 43 43 45 50 54 22 3a 20 22 61 70 70 6c  P_ACCEPT": "appl
1b00: 69 63 61 74 69 6f 6e 2f 6a 73 6f 6e 2c 20 74 65  ication/json, te
1b10: 78 74 2f 6a 61 76 61 73 63 72 69 70 74 2c 20 2a  xt/javascript, *
1b20: 2f 2a 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 43  /*",..        "C
1b30: 4f 4e 54 45 4e 54 5f 4c 45 4e 47 54 48 22 3a 20  ONTENT_LENGTH": 
1b40: 22 33 39 22 2c 0d 0a 20 20 20 20 20 20 20 20 22  "39",..        "
1b50: 53 43 52 49 50 54 5f 46 49 4c 45 4e 41 4d 45 22  SCRIPT_FILENAME"
1b60: 3a 20 22 2f 68 6f 6d 65 2f 73 74 65 70 68 61 6e  : "/home/stephan
1b70: 2f 63 76 73 2f 66 6f 73 73 69 6c 2f 63 73 6f 6e  /cvs/fossil/cson
1b80: 2f 69 6e 64 65 78 2e 63 67 69 22 2c 0d 0a 20 20  /index.cgi",..  
1b90: 20 20 20 20 20 20 22 48 54 54 50 5f 48 4f 53 54        "HTTP_HOST
1ba0: 22 3a 20 22 63 73 6f 6e 2d 63 67 69 22 2c 0d 0a  ": "cson-cgi",..
1bb0: 20 20 20 20 20 20 20 20 22 52 45 51 55 45 53 54          "REQUEST
1bc0: 5f 55 52 49 22 3a 20 22 2f 69 6e 64 65 78 2e 63  _URI": "/index.c
1bd0: 67 69 3f 61 5b 5d 3d 33 26 61 5b 5d 3d 37 22 2c  gi?a[]=3&a[]=7",
1be0: 0d 0a 20 20 20 20 20 20 20 20 22 53 45 52 56 45  ..        "SERVE
1bf0: 52 5f 53 4f 46 54 57 41 52 45 22 3a 20 22 41 70  R_SOFTWARE": "Ap
1c00: 61 63 68 65 2f 32 2e 32 2e 31 36 20 28 55 62 75  ache/2.2.16 (Ubu
1c10: 6e 74 75 29 22 2c 0d 0a 20 20 20 20 20 20 20 20  ntu)",..        
1c20: 22 48 54 54 50 5f 43 4f 4e 4e 45 43 54 49 4f 4e  "HTTP_CONNECTION
1c30: 22 3a 20 22 6b 65 65 70 2d 61 6c 69 76 65 22 2c  ": "keep-alive",
1c40: 0d 0a 20 20 20 20 20 20 20 20 22 48 54 54 50 5f  ..        "HTTP_
1c50: 43 4f 4f 4b 49 45 22 3a 20 22 63 73 6f 6e 5f 73  COOKIE": "cson_s
1c60: 65 73 73 69 6f 6e 5f 69 64 3d 33 39 30 36 33 65  ession_id=39063e
1c70: 65 65 25 32 44 37 65 33 34 25 32 44 36 34 39 66  ee%2D7e34%2D649f
1c80: 25 32 44 64 66 65 64 25 32 44 31 63 66 64 32 63  %2Ddfed%2D1cfd2c
1c90: 36 61 34 35 32 66 22 2c 0d 0a 20 20 20 20 20 20  6a452f",..      
1ca0: 20 20 22 50 41 54 48 22 3a 20 22 2f 75 73 72 2f    "PATH": "/usr/
1cb0: 6c 6f 63 61 6c 2f 62 69 6e 3a 2f 75 73 72 2f 62  local/bin:/usr/b
1cc0: 69 6e 3a 2f 62 69 6e 22 2c 0d 0a 20 20 20 20 20  in:/bin",..     
1cd0: 20 20 20 22 48 54 54 50 5f 41 43 43 45 50 54 5f     "HTTP_ACCEPT_
1ce0: 4c 41 4e 47 55 41 47 45 22 3a 20 22 65 6e 2d 55  LANGUAGE": "en-U
1cf0: 53 2c 65 6e 3b 71 3d 30 2e 38 22 2c 0d 0a 20 20  S,en;q=0.8",..  
1d00: 20 20 20 20 20 20 22 48 54 54 50 5f 52 45 46 45        "HTTP_REFE
1d10: 52 45 52 22 3a 20 22 68 74 74 70 3a 2f 2f 63 73  RER": "http://cs
1d20: 6f 6e 2d 63 67 69 2f 64 65 6d 6f 2e 68 74 6d 6c  on-cgi/demo.html
1d30: 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 53 45 52  ",..        "SER
1d40: 56 45 52 5f 50 52 4f 54 4f 43 4f 4c 22 3a 20 22  VER_PROTOCOL": "
1d50: 48 54 54 50 2f 31 2e 31 22 2c 0d 0a 20 20 20 20  HTTP/1.1",..    
1d60: 20 20 20 20 22 48 54 54 50 5f 41 43 43 45 50 54      "HTTP_ACCEPT
1d70: 5f 45 4e 43 4f 44 49 4e 47 22 3a 20 22 67 7a 69  _ENCODING": "gzi
1d80: 70 2c 64 65 66 6c 61 74 65 2c 73 64 63 68 22 2c  p,deflate,sdch",
1d90: 0d 0a 20 20 20 20 20 20 20 20 22 52 45 51 55 45  ..        "REQUE
1da0: 53 54 5f 4d 45 54 48 4f 44 22 3a 20 22 50 4f 53  ST_METHOD": "POS
1db0: 54 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 53 45  T",..        "SE
1dc0: 52 56 45 52 5f 41 44 4d 49 4e 22 3a 20 22 5b 6e  RVER_ADMIN": "[n
1dd0: 6f 20 61 64 64 72 65 73 73 20 67 69 76 65 6e 5d  o address given]
1de0: 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 53 45 52  ",..        "SER
1df0: 56 45 52 5f 41 44 44 52 22 3a 20 22 31 32 37 2e  VER_ADDR": "127.
1e00: 31 2e 31 2e 31 22 2c 0d 0a 20 20 20 20 20 20 20  1.1.1",..       
1e10: 20 22 50 57 44 22 3a 20 22 2f 68 6f 6d 65 2f 73   "PWD": "/home/s
1e20: 74 65 70 68 61 6e 2f 63 76 73 2f 66 6f 73 73 69  tephan/cvs/fossi
1e30: 6c 2f 63 73 6f 6e 22 2c 0d 0a 20 20 20 20 20 20  l/cson",..      
1e40: 20 20 22 48 54 54 50 5f 4f 52 49 47 49 4e 22 3a    "HTTP_ORIGIN":
1e50: 20 22 68 74 74 70 3a 2f 2f 63 73 6f 6e 2d 63 67   "http://cson-cg
1e60: 69 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 53 45  i",..        "SE
1e70: 52 56 45 52 5f 50 4f 52 54 22 3a 20 22 38 30 22  RVER_PORT": "80"
1e80: 2c 0d 0a 20 20 20 20 20 20 20 20 22 53 43 52 49  ,..        "SCRI
1e90: 50 54 5f 4e 41 4d 45 22 3a 20 22 2f 69 6e 64 65  PT_NAME": "/inde
1ea0: 78 2e 63 67 69 22 2c 0d 0a 20 20 20 20 20 20 20  x.cgi",..       
1eb0: 20 22 53 45 52 56 45 52 5f 4e 41 4d 45 22 3a 20   "SERVER_NAME": 
1ec0: 22 63 73 6f 6e 2d 63 67 69 22 0d 0a 20 20 20 20  "cson-cgi"..    
1ed0: 7d 2c 0d 0a 20 20 20 20 22 24 47 45 54 22 3a 20  },..    "$GET": 
1ee0: 7b 0d 0a 20 20 20 20 20 20 20 20 22 61 22 3a 20  {..        "a": 
1ef0: 5b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 22  [..            "
1f00: 33 22 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20  3",..           
1f10: 20 22 37 22 0d 0a 20 20 20 20 20 20 20 20 5d 0d   "7"..        ].
1f20: 0a 20 20 20 20 7d 2c 0d 0a 20 20 20 20 22 24 43  .    },..    "$C
1f30: 4f 4f 4b 49 45 22 3a 20 7b 0d 0a 20 20 20 20 20  OOKIE": {..     
1f40: 20 20 20 22 63 73 6f 6e 5f 73 65 73 73 69 6f 6e     "cson_session
1f50: 5f 69 64 22 3a 20 7b 0d 0a 20 20 20 20 20 20 20  _id": {..       
1f60: 20 20 20 20 20 22 65 78 70 69 72 65 73 22 3a 20       "expires": 
1f70: 31 33 30 33 32 33 35 39 33 38 2c 0d 0a 20 20 20  1303235938,..   
1f80: 20 20 20 20 20 20 20 20 20 22 76 61 6c 75 65 22           "value"
1f90: 3a 20 22 33 39 30 36 33 65 65 65 2d 37 65 33 34  : "39063eee-7e34
1fa0: 2d 36 34 39 66 2d 64 66 65 64 2d 31 63 66 64 32  -649f-dfed-1cfd2
1fb0: 63 36 61 34 35 32 66 22 0d 0a 20 20 20 20 20 20  c6a452f"..      
1fc0: 20 20 7d 0d 0a 20 20 20 20 7d 2c 0d 0a 20 20 20    }..    },..   
1fd0: 20 22 24 50 4f 53 54 22 3a 20 7b 0d 0a 20 20 20   "$POST": {..   
1fe0: 20 20 20 20 20 22 68 69 22 3a 20 22 77 6f 72 6c       "hi": "worl
1ff0: 64 22 2c 0d 0a 20 20 20 20 20 20 20 20 22 64 65  d",..        "de
2000: 6d 6f 74 69 6d 65 22 3a 20 22 6e 6f 77 22 0d 0a  motime": "now"..
2010: 20 20 20 20 7d 2c 0d 0a 20 20 20 20 22 24 41 50      },..    "$AP
2020: 50 22 3a 20 7b 0d 0a 20 20 20 20 20 20 20 20 22  P": {..        "
2030: 67 75 65 73 73 65 64 4f 75 74 70 75 74 43 6f 6e  guessedOutputCon
2040: 74 65 6e 74 54 79 70 65 22 3a 20 22 61 70 70 6c  tentType": "appl
2050: 69 63 61 74 69 6f 6e 2f 6a 73 6f 6e 22 2c 0d 0a  ication/json",..
2060: 20 20 20 20 20 20 20 20 22 74 69 6d 65 73 74 61          "timesta
2070: 6d 70 22 3a 20 31 33 30 32 36 33 31 31 33 38 0d  mp": 1302631138.
2080: 0a 20 20 20 20 7d 2c 0d 0a 20 20 20 20 22 24 53  .    },..    "$S
2090: 45 53 53 49 4f 4e 22 3a 20 7b 0d 0a 20 20 20 20  ESSION": {..    
20a0: 20 20 20 20 22 74 69 6d 65 73 74 61 6d 70 22 3a      "timestamp":
20b0: 20 31 33 30 32 36 33 31 31 33 38 2c 0d 0a 20 20   1302631138,..  
20c0: 20 20 20 20 20 20 22 68 69 74 73 22 3a 20 31 34        "hits": 14
20d0: 2c 0d 0a 20 20 20 20 20 20 20 20 22 73 65 73 73  ,..        "sess
20e0: 69 6f 6e 4d 61 6e 61 67 65 72 22 3a 20 22 73 71  ionManager": "sq
20f0: 6c 69 74 65 33 22 0d 0a 20 20 20 20 7d 0d 0a 7d  lite3"..    }..}
2100: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0a 0a 5a  ..</verbatim>..Z
2110: 20 66 36 36 64 33 63 36 33 32 32 31 35 61 63 31   f66d3c632215ac1
2120: 39 63 36 35 37 35 64 39 36 39 61 39 30 31 30 31  9c6575d969a90101
2130: 62 0a                                            b.