                                SysLogDevice
                                ============

                              
Requirements
============
RISC OS 3 or later.
26/32 bit compatible.
SysLog.


Installation
============
Use the !Boot System merge tool to merge the supplied system with the one
in this distribution. Or if you prefer, it can be manually installed in
System:310.Modules.


Introduction
============
SysLogDevice provides a write only DeviceFS device driver which sends its
output to a SysLog log. This allows a SysLog log to be written to like a
standard file, e.g.

  *echo Hello { > Devices#log=Test;priority=1:$.SysLog }
  
The data written to the device is assumed to be plain text, each line
terminated by a control character, ASCII 0-31. Empty lines are filtered out.

There is, at present, a limit on the maximum line length (1K at present), any
lines longer than this are broken into multiple log messages.

Multiple streams can be opened onto the same or different logs.


Special Field
=============
The following parameters can be specified in the special field in addition to
those interpreted by DeviceFS:

        log=<name>              Must be present, specifies SysLog log name.
        priority=<number>       Optional SysLog priority, defaults to 64.


Comments and Updates
====================
Please send any bug reports, comments, suggestions etc. by e-mail to 
James Peacock, sw@jip22.freeuk.com. The latest version can be downloaded
from <http://homepage.ntlworld.com/j-peacock/>


Changes
=======
0.02 (24-Jul-2005)
  * No error generated when SysLog not present.

0.01 (09-Jun-2004):
  * First version


License
=======
Copyright (C) 2004, James Peacock.
All rights reserved.

Redistribution and use in binary form, without modification, is permitted
provided that the following conditions are met:

  1. Redistributions in binary form must reproduce the distribution
     unmodified and in its entirety.
     
  2. Redistributions in binary form must be provided free of charge.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN
NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
