~ubuntu-branches/ubuntu/lucid/rsyslog/lucid

« back to all changes in this revision

Viewing changes to rfc3195d.8

  • Committer: Bazaar Package Importer
  • Author(s): Michael Biebl
  • Date: 2007-10-19 17:21:49 UTC
  • Revision ID: james.westby@ubuntu.com-20071019172149-ie6ej2xve33mxiu7
Tags: upstream-1.19.10
ImportĀ upstreamĀ versionĀ 1.19.10

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright 2005 Rainer Gerhards and Adiscon for the rsyslog modifications
 
2
.\" Distributed under the GNU General Public License.
 
3
.\"
 
4
.TH RSYSLOGD 8 "03 July 2007" "Version 1.14.2 (devel)" "Linux System Administration"
 
5
.SH NAME
 
6
rfc3195d \- RFC 3195 listener
 
7
.SH SYNOPSIS
 
8
.B rfc3195d
 
9
.RB [ " \-d " ]
 
10
.RB [ " \-p"
 
11
.IB socket 
 
12
]
 
13
.RB [ " \-r"
 
14
.IB port 
 
15
]
 
16
.RB [ " \-v " ]
 
17
.LP
 
18
.SH DESCRIPTION
 
19
.B Rfc3195d
 
20
is a utility for receiving syslog messages via RFC 3195. Both
 
21
RAW and COOKED profiles are supported (but COOKED only without
 
22
relay-specific PATH elements).
 
23
rfc3195d accepts messages via RFC 3195 and forwards them to
 
24
the local domain socket specified in the -p option
 
25
(/dev/log3195 by default). There, the messages can be picked up
 
26
by the system syslogd. While rfc3195d can work with any syslogd,
 
27
we highly recommend using
 
28
.B rsyslogd,
 
29
because it has special handling
 
30
for the messages forwarded by rfc3195d. To enable message 
 
31
reception in
 
32
.B rsyslogd,
 
33
use the "-a :/dev/log3195" command line
 
34
option (the colon in front of the socket name tells
 
35
.B rsyslogd
 
36
that the messages contain hostnames - this is vital to get the
 
37
right sender name into your logs).
 
38
 
 
39
.B Rfc3195d
 
40
currently has very limited functionality. Most importantly,
 
41
it does not allow to limit the senders it receives messages from.
 
42
Documentation is also very sparse. The situation should improve over
 
43
time as the rsyslog project is continously being enhanced.
 
44
.LP
 
45
.SH OPTIONS
 
46
.TP
 
47
.BI "\-p " "socket"
 
48
The socket the received messages are to be sent to. If not specified,
 
49
/dev/log3195 is used.
 
50
.TP
 
51
.BI "\-r " "port"
 
52
The listen port to use. If not specified, IANA-assigned port 601 is used.
 
53
.TP
 
54
.B "\-d"
 
55
Turns on debug mode.  In it, rfc3195d spits out diagnostic information
 
56
to stdout.
 
57
.TP
 
58
.B "\-v"
 
59
Print version and exit.
 
60
.SH SIGNALS
 
61
.B Rfc3195d
 
62
reacts to a set of signals.
 
63
.TP
 
64
.B SIGTERM
 
65
.B Rfc3195d
 
66
terminates.
 
67
.TP
 
68
.B SIGUSR1
 
69
.B Rfc3195d
 
70
terminates.
 
71
.LP
 
72
.SH SEE ALSO
 
73
.BR rsyslog.conf (5),
 
74
.BR rsyslogd (8)
 
75
.LP
 
76
.SH MORE INFORMATION
 
77
Is available on the project home page at http://www.rsyslog.com
 
78
.LP
 
79
.SH COLLABORATORS
 
80
Rfc3195d uses liblogging (http://www.liblogging.org) for RFC 3195
 
81
protocol handling.
 
82
.PD 0
 
83
.TP
 
84
Rainer Gerhards <rgerhards@adiscon.com>
 
85
.zZ