| Name : perl-Unix-Syslog
| |
| Version : 1.1
| Vendor : obs://build_opensuse_org/devel:languages:perl
|
| Release : lp154.1.1
| Date : 2023-01-27 17:04:25
|
| Group : Development/Libraries/Perl
| Source RPM : perl-Unix-Syslog-1.1-lp154.1.1.src.rpm
|
| Size : 0.05 MB
| |
| Packager : https://www_suse_com/
| |
| Summary : Perl interface to the UNIX syslog(3) calls
|
Description :
This module provides an interface to the system logger *syslogd*(8) via
Perl\'s XSUBs. The implementation attempts to resemble the native
libc-functions of your system, so that anyone being familiar with
_syslog.h_ should be able to use this module right away.
In contrary to Sys::Syslog(3), this modules does not open a network
connection to send the messages. This can help you to avoid opening
security holes in your computer (see \"FAQ\").
The subs imported by the tag \'macros\' are simply wrappers around the most
important \'#defines\' in your system\'s C header file _syslog.h_. The macros
return integer values that are used to specify options, facilities and
priorities in a more or less portable way. They also provide general
information about your local syslog mechanism. Check syslog(3) and your
local _syslog.h_ for information about the macros, options and facilities
available on your system.
The following functions are provided:
* openlog $ident, $option, $facility
opens a connection to the system logger. _$ident_ is an identifier string
that *syslogd*(8) prints into every message. It usually equals the process
name. _$option_ is an integer value that is the result of ORed options.
_$facility_ is an integer value that specifies the part of the system the
message should be associated with (e.g. kernel message, mail subsystem).
* syslog $priority, $format, AATTformatargs
Generates a log message and passes it to the system logger. If \'syslog()\'
is called without calling \'openlog()\' first, probably system dependent
default values will be used as arguments for an implicit call to
\'openlog()\'.
_$priority_ is an integer value that specifies the priority of the message.
Alternatively _$priority_ can be the ORed value of a priority and a
facility. In that case a previously selected facility will be overridden.
In the case that \'syslog()\' is called without calling \'openlog()\' first and
_priority_ does not specify both a priority _and_ a facility, a default
facility will be used. This behaviour is most likely system dependent and
the user should not rely on any particular value in that case.
_$format_ is a format string in the style of printf(3). Additionally to the
usual printf directives \'%m\' can be specified in the string. It will be
replaced implicitly by the contents of the Perl variable \'$!\' (\'$ERRNO\').
_AATTformatargs_ is a list of values that the format directives will be
replaced with subsequently.
* closelog
closes the connection to the system logger.
* setlogmask $mask_priority
sets the priority mask and returns the old mask. Logging is enabled for the
priorities indicated by the bits in the mask that are set and is disabled
where the bits are not set. Macros are provided to specify valid and
portable arguments to \'setlogmask()\'. Usually the default log mask allows
all messages to be logged.
* priorityname $priority
returns a string containing the name of _$priority_ as string. If this
functionality has not been enabled at installation, the function returns
_undef_.
* facilityname $facility
returns a string containing the name of _$facility_ as string. If this
functionality has not been enabled at installation, the function returns
_undef_.
*NOTE*: The behaviour of this module is system dependent. It is highly
recommended to consult your system manual for available macros and the
behaviour of the provided functions.
|
RPM found in directory: /packages/linux-pbone/ftp5.gwdg.de/pub/opensuse/repositories/devel:/languages:/perl:/CPAN-U/15.4/x86_64 |
