1*2dc7e66cSDamjan Jovanovic/************************************************************** 2*2dc7e66cSDamjan Jovanovic * 3*2dc7e66cSDamjan Jovanovic * Licensed to the Apache Software Foundation (ASF) under one 4*2dc7e66cSDamjan Jovanovic * or more contributor license agreements. See the NOTICE file 5*2dc7e66cSDamjan Jovanovic * distributed with this work for additional information 6*2dc7e66cSDamjan Jovanovic * regarding copyright ownership. The ASF licenses this file 7*2dc7e66cSDamjan Jovanovic * to you under the Apache License, Version 2.0 (the 8*2dc7e66cSDamjan Jovanovic * "License"); you may not use this file except in compliance 9*2dc7e66cSDamjan Jovanovic * with the License. You may obtain a copy of the License at 10*2dc7e66cSDamjan Jovanovic * 11*2dc7e66cSDamjan Jovanovic * http://www.apache.org/licenses/LICENSE-2.0 12*2dc7e66cSDamjan Jovanovic * 13*2dc7e66cSDamjan Jovanovic * Unless required by applicable law or agreed to in writing, 14*2dc7e66cSDamjan Jovanovic * software distributed under the License is distributed on an 15*2dc7e66cSDamjan Jovanovic * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*2dc7e66cSDamjan Jovanovic * KIND, either express or implied. See the License for the 17*2dc7e66cSDamjan Jovanovic * specific language governing permissions and limitations 18*2dc7e66cSDamjan Jovanovic * under the License. 19*2dc7e66cSDamjan Jovanovic * 20*2dc7e66cSDamjan Jovanovic *************************************************************/ 21*2dc7e66cSDamjan Jovanovic 22*2dc7e66cSDamjan Jovanovic 23*2dc7e66cSDamjan Jovanovic 24*2dc7e66cSDamjan Jovanovic#ifndef __com_sun_star_logging_SyslogHandler_idl__ 25*2dc7e66cSDamjan Jovanovic#define __com_sun_star_logging_SyslogHandler_idl__ 26*2dc7e66cSDamjan Jovanovic 27*2dc7e66cSDamjan Jovanovic#ifndef __com_sun_star_lang_IllegalArgumentException_idl__ 28*2dc7e66cSDamjan Jovanovic#include <com/sun/star/lang/IllegalArgumentException.idl> 29*2dc7e66cSDamjan Jovanovic#endif 30*2dc7e66cSDamjan Jovanovic#ifndef __com_sun_star_beans_NamedValue_idl__ 31*2dc7e66cSDamjan Jovanovic#include <com/sun/star/beans/NamedValue.idl> 32*2dc7e66cSDamjan Jovanovic#endif 33*2dc7e66cSDamjan Jovanovic 34*2dc7e66cSDamjan Jovanovic//============================================================================= 35*2dc7e66cSDamjan Jovanovic 36*2dc7e66cSDamjan Jovanovicmodule com { module sun { module star { module logging { 37*2dc7e66cSDamjan Jovanovic 38*2dc7e66cSDamjan Jovanovicinterface XLogHandler; 39*2dc7e66cSDamjan Jovanovic 40*2dc7e66cSDamjan Jovanovic//============================================================================= 41*2dc7e66cSDamjan Jovanovic 42*2dc7e66cSDamjan Jovanovic/** specifies a component implementing a log handler whose output 43*2dc7e66cSDamjan Jovanovic channel is the syslog network protocol. 44*2dc7e66cSDamjan Jovanovic 45*2dc7e66cSDamjan Jovanovic <p>The handler will use the <code>Encoding</code> attribute of <type>XLogHandler</type> 46*2dc7e66cSDamjan Jovanovic to determine how to encode strings before actually writing them to the output 47*2dc7e66cSDamjan Jovanovic file.</p> 48*2dc7e66cSDamjan Jovanovic 49*2dc7e66cSDamjan Jovanovic <p>The output is sent over UDP to the given Host and Port 50*2dc7e66cSDamjan Jovanovic in RFC5424 format, in plaintext, with APPNAME "soffice" and facility USER. 51*2dc7e66cSDamjan Jovanovic LogLevel::SEVERE becomes syslog's "error" severity, LogLevel::WARNING becomes syslog's 52*2dc7e66cSDamjan Jovanovic "warning" severity, LogLevel::INFO and LogLevel::CONFIG become syslog's "notice" 53*2dc7e66cSDamjan Jovanovic severity, and LogLevel::FINE and below become syslog's "debug" severity.</p> 54*2dc7e66cSDamjan Jovanovic 55*2dc7e66cSDamjan Jovanovic @see XLogHandler::Encoding 56*2dc7e66cSDamjan Jovanovic 57*2dc7e66cSDamjan Jovanovic @since OpenOffice 4.5 58*2dc7e66cSDamjan Jovanovic */ 59*2dc7e66cSDamjan Jovanovicservice SyslogHandler : XLogHandler 60*2dc7e66cSDamjan Jovanovic{ 61*2dc7e66cSDamjan Jovanovic /** creates an instance of the log handler 62*2dc7e66cSDamjan Jovanovic 63*2dc7e66cSDamjan Jovanovic @param Settings 64*2dc7e66cSDamjan Jovanovic contains the initial settings for the log handler 65*2dc7e66cSDamjan Jovanovic 66*2dc7e66cSDamjan Jovanovic <p>The following settings are recognized and supported: 67*2dc7e66cSDamjan Jovanovic <ul><li><code>Encoding</code> - denotes the initial value of the <member>XLogHandler::Encoding</member></li> 68*2dc7e66cSDamjan Jovanovic <li><code>Formatter</code> - denotes the initial value of the <member>XLogHandler::Formatter</member></li> 69*2dc7e66cSDamjan Jovanovic <li><code>Level</code> - denotes the initial value of the <member>XLogHandler::Level</member></li> 70*2dc7e66cSDamjan Jovanovic </ul></p> 71*2dc7e66cSDamjan Jovanovic 72*2dc7e66cSDamjan Jovanovic <p>Additionally, the following settings are required for this particular handler: 73*2dc7e66cSDamjan Jovanovic <ul><li><code>Host</code> - the hostname of the syslog server</li> 74*2dc7e66cSDamjan Jovanovic <li><code>Port</code> - the port of the syslog server</li> 75*2dc7e66cSDamjan Jovanovic </ul></p> 76*2dc7e66cSDamjan Jovanovic 77*2dc7e66cSDamjan Jovanovic @throws ::com::sun::star::lang::IllegalArgumentException 78*2dc7e66cSDamjan Jovanovic if <arg>Settings</args> contains settings whose value is of the wrong type. 79*2dc7e66cSDamjan Jovanovic */ 80*2dc7e66cSDamjan Jovanovic createWithSettings( [in] sequence< ::com::sun::star::beans::NamedValue > Settings ) 81*2dc7e66cSDamjan Jovanovic raises ( ::com::sun::star::lang::IllegalArgumentException ); 82*2dc7e66cSDamjan Jovanovic}; 83*2dc7e66cSDamjan Jovanovic 84*2dc7e66cSDamjan Jovanovic//============================================================================= 85*2dc7e66cSDamjan Jovanovic 86*2dc7e66cSDamjan Jovanovic}; }; }; }; 87*2dc7e66cSDamjan Jovanovic 88*2dc7e66cSDamjan Jovanovic//============================================================================= 89*2dc7e66cSDamjan Jovanovic 90*2dc7e66cSDamjan Jovanovic#endif 91