| :: | Software | :: | ucspi-ssl |
sslperl opts file progwhere opts is a series of sslhandle server options, file names a file containing perl code, and prog is one or more arguments specifying a perl subroutine plus arguments to run for each accepted connection.
sslperl forks the requested number of children, each listening for TCP client connections. Before handling any requests, each child parses and runs the perl code in file. The file should end with a true expression, like a module.
To handle a request, a child process executes prog as a perl subroutine, with file descriptor 0 reading from the network and file descriptor 1 writing to the network. Before handling the request, the child sets certain environment variables, a la sslserver.
Each invocation of prog handles a single request. It is called within a loop, with one iteration per request, and therefore must release any resources allocated to handle a particular request.
If prog exits while handling a request, sslperl will start a new child process.
sslperl.c If your server uses a module like DBI.pm you may need to add the requisite xs code.
conf-ldperl Determine options required to load sslperl. By default, these are calculated automatically. Using xs code in src/sslperl.c may require manual option setting in src/conf-ldperl.
conf-ccperl Determine options required to compile sslperl. By default, these are calculated automatically.
conf-perl How to invoke perl to calculate options automatically in conf-ccperl and conf-ldperl.