Introduction
Introduction Statistics Contact Development Disclaimer Help
Adding CGI documentation. - geomyidae - A small C-based gopherd.
git clone git://bitreich.org/geomyidae/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfri…
Log
Files
Refs
Tags
README
LICENSE
---
commit 7114924898ed83d3a4eb3f0a59f9047ed3877ba4
parent 6f4cbad45b4f91422cc14d1b843c754b234ffffe
Author: Christoph Lohmann <[email protected]>
Date: Sat, 12 Mar 2011 21:00:36 +0100
Adding CGI documentation.
Diffstat:
A CGI | 73 +++++++++++++++++++++++++++++…
M Makefile | 2 +-
2 files changed, 74 insertions(+), 1 deletion(-)
---
diff --git a/CGI b/CGI
@@ -0,0 +1,73 @@
+INTRODUCTION
+
+Geomyidae has support for running scripts on each request, which will generate
+dynamic content.
+
+There are two modes: standard cgi and dynamic cgi.
+(»CGI« as name was just taken, because that's easier to compare to the web.)
+
+
+PERMISSIONS
+
+The scripts are run using the permissions of geomyidae. It is adived to use
+the -g and -u option of gemoyidae.
+
+
+BEFOREHAND
+
+In these examples C: is what the client sends and S: what the server is
+sending.
+
+
+CALLING CONVENTION
+
+ % $gopherroot/test.cgi $search $arguments
+
+ C: /test.cgi
+ -> $search = ""
+ -> $arguments = server host
+
+ C: /test.cgi searchterm (There is a Tab inbetwee…
+ -> $search = »searchterm«
+ -> $arguments = server host
+
+ C: /test.cgi?hello=world
+ -> $search = ""
+ -> $arguments = »hello=world«
+
+ C: /test.cgi?hello=world searchterm (Beware! A Tab!)
+ -> $search = »searchterm«
+ -> $arguments = »hello=world«
+
+The examples should be enough for understanding it.
+
+
+STANDARD CGI
+
+The file extension »cgi« switches to this mode, where the output of the
+script is not interpreted at all by the server and the client needs to send
+raw Gopher menus/files.
+
+ % cat test.cgi
+ #!/bin/sh
+ echo "Hello my friend."
+ %
+
+ S: Hello my friend.
+
+
+DYNAMIC CGI
+
+For using dynamic CGI, the file needs to end in »dcgi«, which will switch on
+the interpretation of the returned lines by the script. The interpreted for-
+mat is the same as in the *.gph files.
+
+ % cat test.dcgi
+ #!/bin/sh
+ echo "[1|Some link|/somewhere|server|port]"
+ %
+
+ S: 1Some link /somewhere gopher.r-36.net 70
+
+Have fun!
+
diff --git a/Makefile b/Makefile
@@ -56,7 +56,7 @@ uninstall:
dist: clean
@echo creating dist tarball
@mkdir -p ${NAME}-${VERSION}
- @cp -R rc.d README LICENSE index.gph Makefile ${NAME}.8 \
+ @cp -R rc.d CGI README LICENSE index.gph Makefile ${NAME}.8 \
*.c *.h ${NAME}-${VERSION}
@tar -cf ${NAME}-${VERSION}.tar ${NAME}-${VERSION}
@gzip ${NAME}-${VERSION}.tar
You are viewing proxied material from bitreich.org. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.