The ls.cgi internal program
ls.cgi is a binary that is suitable for using as a CGI script, e.g. called index.cgi, in a Web document hierarchy served by tipidee, when the goal of the index file is only to list the contents of the directory it resides in.
Interface
ls.cgi
- It is not meant to be invoked by users. It will fail if invoked outside of a CGI script context. As such, it is unexported (it will appear in libexecdir, not in bindir).
- It is meant to be placed in the repository of CGI scripts and symlinked as index.cgi in the places where the URL of a directory should list the contents of said directory.
- For instance, if example.com:443/index.cgi is a copy of, or a symlink to, ls.cgi, and the tipidee configuration says that this binary is meant to be a CGI script, then access to https://example.com will list the files available in the example.com:443/ directory.
Exit codes
- 0
- success
- 100
- wrong usage
- 111
- system call failed
Notes
- ls.cgi is very minimalistic. It provides no CSS or anything else than the bare list of files. It is provided as an example of how CGI scripts can work with tipidee.