sescle
Last Updated: %%mtime(%c)

%!target: man
%!encoding: utf-8

= NAME =

sescle - PHP session file cleanup daemon

= SYNOPSIS =

**sescle** -p //path// -i //path// -v -h

= DESCRIPTION =

**sescle** is a utility which monitors the PHP session directory and automatically removes expired files. This is suitable for high-load or high-security situations where session files must be removed frequently and on-time.

It obtains its configuration information by using the //php// executable and optionally a user specified //.ini// file. In most situations it will run out of the box with no additional options provided.

= OPTIONS =

There are no required options.

: **-p** path
  Path to the PHP interpreter
: **-i** path
  Path to the //php.ini// file for configuration values.
: **-v**
  Be verbose, may be repeated upto 4 times.
: **-h**
  Display usage information and exit.


= SECURITY =

As of version 0.1 there are known race conditions which may lead to arbitrary file deletion. The cause of these is there is no specific handling of symlinks.

Until these issues are resolved, this application must not be run in a shared-hosting environment.

//sescle// must run as the same user the //php// session files are being written as, usually this is 'nobody', 'www' or 'apache'.

= BUGS =

Please submit bug reports, patches or improvements to harry.roberts@midnight-labs.org


= LICENSE =

Copyright (c) 2008 Telappliant Ltd.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.