2000-04-24 05:55:14 +02:00
|
|
|
@node Syslog, Mathematics, Low-Level Terminal Interface, Top
|
|
|
|
@c %MENU% System logging and messaging
|
|
|
|
@chapter Syslog
|
|
|
|
|
|
|
|
|
|
|
|
This chapter describes facilities for issuing and logging messages of
|
|
|
|
system administration interest. This chapter has nothing to do with
|
|
|
|
programs issuing messages to their own users or keeping private logs
|
|
|
|
(One would typically do that with the facilities described in
|
|
|
|
@ref{I/O on Streams}).
|
|
|
|
|
|
|
|
Most systems have a facility called ``Syslog'' that allows programs to
|
|
|
|
submit messages of interest to system administrators and can be
|
|
|
|
configured to pass these messages on in various ways, such as printing
|
|
|
|
on the console, mailing to a particular person, or recording in a log
|
|
|
|
file for future reference.
|
|
|
|
|
|
|
|
A program uses the facilities in this chapter to submit such messages.
|
|
|
|
|
|
|
|
@menu
|
|
|
|
* Overview of Syslog:: Overview of a system's Syslog facility
|
|
|
|
* Submitting Syslog Messages:: Functions to submit messages to Syslog
|
|
|
|
@end menu
|
|
|
|
|
|
|
|
@node Overview of Syslog
|
|
|
|
@section Overview of Syslog
|
|
|
|
|
|
|
|
System administrators have to deal with lots of different kinds of
|
|
|
|
messages from a plethora of subsystems within each system, and usually
|
|
|
|
lots of systems as well. For example, an FTP server might report every
|
|
|
|
connection it gets. The kernel might report hardware failures on a disk
|
|
|
|
drive. A DNS server might report usage statistics at regular intervals.
|
|
|
|
|
|
|
|
Some of these messages need to be brought to a system administrator's
|
|
|
|
attention immediately. And it may not be just any system administrator
|
|
|
|
-- there may be a particular system administrator who deals with a
|
|
|
|
particular kind of message. Other messages just need to be recorded for
|
|
|
|
future reference if there is a problem. Still others may need to have
|
|
|
|
information extracted from them by an automated process that generates
|
|
|
|
monthly reports.
|
|
|
|
|
|
|
|
To deal with these messages, most Unix systems have a facility called
|
|
|
|
"Syslog." It is generally based on a daemon called ``Syslogd''
|
|
|
|
Syslogd listens for messages on a Unix domain socket named
|
|
|
|
@file{/dev/log}. Based on classification information in the messages
|
|
|
|
and its configuration file (usually @file{/etc/syslog.conf}), Syslogd
|
|
|
|
routes them in various ways. Some of the popular routings are:
|
|
|
|
|
|
|
|
@itemize @bullet
|
|
|
|
@item
|
|
|
|
Write to the system console
|
|
|
|
@item
|
|
|
|
Mail to a specific user
|
|
|
|
@item
|
|
|
|
Write to a log file
|
|
|
|
@item
|
|
|
|
Pass to another daemon
|
|
|
|
@item
|
|
|
|
Discard
|
|
|
|
@end itemize
|
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
Syslogd can also handle messages from other systems. It listens on the
|
2000-04-24 05:55:14 +02:00
|
|
|
@code{syslog} UDP port as well as the local socket for messages.
|
|
|
|
|
|
|
|
Syslog can handle messages from the kernel itself. But the kernel
|
|
|
|
doesn't write to @file{/dev/log}; rather, another daemon (sometimes
|
|
|
|
called ``Klogd'') extracts messages from the kernel and passes them on to
|
|
|
|
Syslog as any other process would (and it properly identifies them as
|
|
|
|
messages from the kernel).
|
|
|
|
|
|
|
|
Syslog can even handle messages that the kernel issued before Syslogd or
|
|
|
|
Klogd was running. A Linux kernel, for example, stores startup messages
|
|
|
|
in a kernel message ring and they are normally still there when Klogd
|
|
|
|
later starts up. Assuming Syslogd is running by the time Klogd starts,
|
|
|
|
Klogd then passes everything in the message ring to it.
|
|
|
|
|
|
|
|
In order to classify messages for disposition, Syslog requires any process
|
|
|
|
that submits a message to it to provide two pieces of classification
|
|
|
|
information with it:
|
|
|
|
|
|
|
|
@table @asis
|
|
|
|
@item facility
|
|
|
|
This identifies who submitted the message. There are a small number of
|
|
|
|
facilities defined. The kernel, the mail subsystem, and an FTP server
|
|
|
|
are examples of recognized facilities. For the complete list,
|
|
|
|
@xref{syslog; vsyslog}. Keep in mind that these are
|
|
|
|
essentially arbitrary classifications. "Mail subsystem" doesn't have any
|
|
|
|
more meaning than the system administrator gives to it.
|
|
|
|
|
|
|
|
@item priority
|
|
|
|
This tells how important the content of the message is. Examples of
|
|
|
|
defined priority values are: debug, informational, warning, critical.
|
2007-10-28 09:24:07 +01:00
|
|
|
For the complete list, see @ref{syslog; vsyslog}. Except for
|
2000-04-24 05:55:14 +02:00
|
|
|
the fact that the priorities have a defined order, the meaning of each
|
|
|
|
of these priorities is entirely determined by the system administrator.
|
|
|
|
|
|
|
|
@end table
|
|
|
|
|
|
|
|
A ``facility/priority'' is a number that indicates both the facility
|
|
|
|
and the priority.
|
|
|
|
|
|
|
|
@strong{Warning:} This terminology is not universal. Some people use
|
|
|
|
``level'' to refer to the priority and ``priority'' to refer to the
|
|
|
|
combination of facility and priority. A Linux kernel has a concept of a
|
|
|
|
message ``level,'' which corresponds both to a Syslog priority and to a
|
|
|
|
Syslog facility/priority (It can be both because the facility code for
|
|
|
|
the kernel is zero, and that makes priority and facility/priority the
|
|
|
|
same value).
|
|
|
|
|
2012-02-28 15:44:20 +01:00
|
|
|
@Theglibc{} provides functions to submit messages to Syslog. They
|
2000-04-24 05:55:14 +02:00
|
|
|
do it by writing to the @file{/dev/log} socket. @xref{Submitting Syslog
|
|
|
|
Messages}.
|
|
|
|
|
2012-02-28 15:44:20 +01:00
|
|
|
The @glibcadj{} functions only work to submit messages to the Syslog
|
2000-04-24 05:55:14 +02:00
|
|
|
facility on the same system. To submit a message to the Syslog facility
|
|
|
|
on another system, use the socket I/O functions to write a UDP datagram
|
|
|
|
to the @code{syslog} UDP port on that system. @xref{Sockets}.
|
|
|
|
|
|
|
|
|
|
|
|
@node Submitting Syslog Messages
|
|
|
|
@section Submitting Syslog Messages
|
|
|
|
|
2012-02-28 15:44:20 +01:00
|
|
|
@Theglibc{} provides functions to submit messages to the Syslog
|
2000-04-24 05:55:14 +02:00
|
|
|
facility:
|
|
|
|
|
|
|
|
@menu
|
|
|
|
* openlog:: Open connection to Syslog
|
|
|
|
* syslog; vsyslog:: Submit message to Syslog
|
|
|
|
* closelog:: Close connection to Syslog
|
|
|
|
* setlogmask:: Cause certain messages to be ignored
|
|
|
|
* Syslog Example:: Example of all of the above
|
|
|
|
@end menu
|
|
|
|
|
|
|
|
These functions only work to submit messages to the Syslog facility on
|
|
|
|
the same system. To submit a message to the Syslog facility on another
|
|
|
|
system, use the socket I/O functions to write a UDP datagram to the
|
|
|
|
@code{syslog} UDP port on that system. @xref{Sockets}.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@node openlog
|
|
|
|
@subsection openlog
|
|
|
|
|
|
|
|
The symbols referred to in this section are declared in the file
|
|
|
|
@file{syslog.h}.
|
|
|
|
|
|
|
|
@comment syslog.h
|
|
|
|
@comment BSD
|
2002-01-18 07:26:02 +01:00
|
|
|
@deftypefun void openlog (const char *@var{ident}, int @var{option}, int @var{facility})
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@code{openlog} opens or reopens a connection to Syslog in preparation
|
|
|
|
for submitting messages.
|
|
|
|
|
|
|
|
@var{ident} is an arbitrary identification string which future
|
|
|
|
@code{syslog} invocations will prefix to each message. This is intended
|
|
|
|
to identify the source of the message, and people conventionally set it
|
|
|
|
to the name of the program that will submit the messages.
|
|
|
|
|
2002-01-18 07:26:02 +01:00
|
|
|
If @var{ident} is NULL, or if @code{openlog} is not called, the default
|
|
|
|
identification string used in Syslog messages will be the program name,
|
|
|
|
taken from argv[0].
|
|
|
|
|
|
|
|
Please note that the string pointer @var{ident} will be retained
|
|
|
|
internally by the Syslog routines. You must not free the memory that
|
|
|
|
@var{ident} points to. It is also dangerous to pass a reference to an
|
|
|
|
automatic variable since leaving the scope would mean ending the
|
|
|
|
lifetime of the variable. If you want to change the @var{ident} string,
|
|
|
|
you must call @code{openlog} again; overwriting the string pointed to by
|
|
|
|
@var{ident} is not thread-safe.
|
|
|
|
|
|
|
|
You can cause the Syslog routines to drop the reference to @var{ident} and
|
|
|
|
go back to the default string (the program name taken from argv[0]), by
|
|
|
|
calling @code{closelog}: @xref{closelog}.
|
|
|
|
|
|
|
|
In particular, if you are writing code for a shared library that might get
|
|
|
|
loaded and then unloaded (e.g. a PAM module), and you use @code{openlog},
|
|
|
|
you must call @code{closelog} before any point where your library might
|
|
|
|
get unloaded, as in this example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
#include <syslog.h>
|
|
|
|
|
|
|
|
void
|
|
|
|
shared_library_function (void)
|
|
|
|
@{
|
|
|
|
openlog ("mylibrary", option, priority);
|
|
|
|
|
|
|
|
syslog (LOG_INFO, "shared library has been invoked");
|
|
|
|
|
|
|
|
closelog ();
|
|
|
|
@}
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
Without the call to @code{closelog}, future invocations of @code{syslog}
|
|
|
|
by the program using the shared library may crash, if the library gets
|
|
|
|
unloaded and the memory containing the string @code{"mylibrary"} becomes
|
|
|
|
unmapped. This is a limitation of the BSD syslog interface.
|
|
|
|
|
2000-04-24 05:55:14 +02:00
|
|
|
@code{openlog} may or may not open the @file{/dev/log} socket, depending
|
2001-02-11 20:15:00 +01:00
|
|
|
on @var{option}. If it does, it tries to open it and connect it as a
|
2000-04-24 05:55:14 +02:00
|
|
|
stream socket. If that doesn't work, it tries to open it and connect it
|
|
|
|
as a datagram socket. The socket has the ``Close on Exec'' attribute,
|
|
|
|
so the kernel will close it if the process performs an exec.
|
|
|
|
|
|
|
|
You don't have to use @code{openlog}. If you call @code{syslog} without
|
|
|
|
having called @code{openlog}, @code{syslog} just opens the connection
|
|
|
|
implicitly and uses defaults for the information in @var{ident} and
|
2001-02-11 20:15:00 +01:00
|
|
|
@var{options}.
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@var{options} is a bit string, with the bits as defined by the following
|
|
|
|
single bit masks:
|
|
|
|
|
|
|
|
@table @code
|
|
|
|
@item LOG_PERROR
|
|
|
|
If on, @code{openlog} sets up the connection so that any @code{syslog}
|
|
|
|
on this connection writes its message to the calling process' Standard
|
|
|
|
Error stream in addition to submitting it to Syslog. If off, @code{syslog}
|
|
|
|
does not write the message to Standard Error.
|
|
|
|
|
|
|
|
@item LOG_CONS
|
|
|
|
If on, @code{openlog} sets up the connection so that a @code{syslog} on
|
|
|
|
this connection that fails to submit a message to Syslog writes the
|
|
|
|
message instead to system console. If off, @code{syslog} does not write
|
|
|
|
to the system console (but of course Syslog may write messages it
|
|
|
|
receives to the console).
|
|
|
|
|
|
|
|
@item LOG_PID
|
|
|
|
When on, @code{openlog} sets up the connection so that a @code{syslog}
|
|
|
|
on this connection inserts the calling process' Process ID (PID) into
|
|
|
|
the message. When off, @code{openlog} does not insert the PID.
|
|
|
|
|
|
|
|
@item LOG_NDELAY
|
|
|
|
When on, @code{openlog} opens and connects the @file{/dev/log} socket.
|
|
|
|
When off, a future @code{syslog} call must open and connect the socket.
|
|
|
|
|
|
|
|
@strong{Portability note:} In early systems, the sense of this bit was
|
|
|
|
exactly the opposite.
|
|
|
|
|
|
|
|
@item LOG_ODELAY
|
|
|
|
This bit does nothing. It exists for backward compatibility.
|
|
|
|
|
|
|
|
@end table
|
|
|
|
|
|
|
|
If any other bit in @var{options} is on, the result is undefined.
|
|
|
|
|
|
|
|
@var{facility} is the default facility code for this connection. A
|
|
|
|
@code{syslog} on this connection that specifies default facility causes
|
|
|
|
this facility to be associated with the message. See @code{syslog} for
|
|
|
|
possible values. A value of zero means the default default, which is
|
|
|
|
@code{LOG_USER}.
|
|
|
|
|
|
|
|
If a Syslog connection is already open when you call @code{openlog},
|
|
|
|
@code{openlog} ``reopens'' the connection. Reopening is like opening
|
|
|
|
except that if you specify zero for the default facility code, the
|
|
|
|
default facility code simply remains unchanged and if you specify
|
|
|
|
LOG_NDELAY and the socket is already open and connected, @code{openlog}
|
|
|
|
just leaves it that way.
|
|
|
|
|
|
|
|
@c There is a bug in closelog() (glibc 2.1.3) wherein it does not reset the
|
|
|
|
@c default log facility to LOG_USER, which means the default default log
|
|
|
|
@c facility could be whatever the default log facility was for a previous
|
|
|
|
@c Syslog connection. I have documented what the function should be rather
|
|
|
|
@c than what it is because I think if anyone ever gets concerned, the code
|
|
|
|
@c will change.
|
|
|
|
|
|
|
|
@end deftypefun
|
|
|
|
|
|
|
|
|
|
|
|
@node syslog; vsyslog
|
|
|
|
@subsection syslog, vsyslog
|
|
|
|
|
|
|
|
The symbols referred to in this section are declared in the file
|
|
|
|
@file{syslog.h}.
|
|
|
|
|
|
|
|
@c syslog() is implemented as a call to vsyslog().
|
|
|
|
@comment syslog.h
|
|
|
|
@comment BSD
|
2012-02-17 18:44:38 +01:00
|
|
|
@deftypefun void syslog (int @var{facility_priority}, char *@var{format}, @dots{})
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@code{syslog} submits a message to the Syslog facility. It does this by
|
|
|
|
writing to the Unix domain socket @code{/dev/log}.
|
|
|
|
|
|
|
|
@code{syslog} submits the message with the facility and priority indicated
|
|
|
|
by @var{facility_priority}. The macro @code{LOG_MAKEPRI} generates a
|
2001-02-11 20:15:00 +01:00
|
|
|
facility/priority from a facility and a priority, as in the following
|
2000-04-24 05:55:14 +02:00
|
|
|
example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
LOG_MAKEPRI(LOG_USER, LOG_WARNING)
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
The possible values for the facility code are (macros):
|
|
|
|
|
|
|
|
@c Internally, there is also LOG_KERN, but LOG_KERN == 0, which means
|
|
|
|
@c if you try to use it here, just selects default.
|
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
@vtable @code
|
2000-04-24 05:55:14 +02:00
|
|
|
@item LOG_USER
|
|
|
|
A miscellaneous user process
|
|
|
|
@item LOG_MAIL
|
|
|
|
Mail
|
|
|
|
@item LOG_DAEMON
|
|
|
|
A miscellaneous system daemon
|
|
|
|
@item LOG_AUTH
|
|
|
|
Security (authorization)
|
|
|
|
@item LOG_SYSLOG
|
|
|
|
Syslog
|
|
|
|
@item LOG_LPR
|
|
|
|
Central printer
|
|
|
|
@item LOG_NEWS
|
|
|
|
Network news (e.g. Usenet)
|
|
|
|
@item LOG_UUCP
|
|
|
|
UUCP
|
|
|
|
@item LOG_CRON
|
|
|
|
Cron and At
|
|
|
|
@item LOG_AUTHPRIV
|
|
|
|
Private security (authorization)
|
|
|
|
@item LOG_FTP
|
|
|
|
Ftp server
|
|
|
|
@item LOG_LOCAL0
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL1
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL2
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL3
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL4
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL5
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL6
|
|
|
|
Locally defined
|
|
|
|
@item LOG_LOCAL7
|
|
|
|
Locally defined
|
2001-02-11 20:15:00 +01:00
|
|
|
@end vtable
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
Results are undefined if the facility code is anything else.
|
|
|
|
|
2008-08-02 18:30:28 +02:00
|
|
|
@strong{NB:} @code{syslog} recognizes one other facility code: that of
|
2001-02-11 20:15:00 +01:00
|
|
|
the kernel. But you can't specify that facility code with these
|
|
|
|
functions. If you try, it looks the same to @code{syslog} as if you are
|
|
|
|
requesting the default facility. But you wouldn't want to anyway,
|
2012-02-28 15:44:20 +01:00
|
|
|
because any program that uses @theglibc{} is not the kernel.
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
You can use just a priority code as @var{facility_priority}. In that
|
|
|
|
case, @code{syslog} assumes the default facility established when the
|
|
|
|
Syslog connection was opened. @xref{Syslog Example}.
|
|
|
|
|
|
|
|
The possible values for the priority code are (macros):
|
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
@vtable @code
|
2000-04-24 05:55:14 +02:00
|
|
|
@item LOG_EMERG
|
|
|
|
The message says the system is unusable.
|
|
|
|
@item LOG_ALERT
|
|
|
|
Action on the message must be taken immediately.
|
|
|
|
@item LOG_CRIT
|
|
|
|
The message states a critical condition.
|
|
|
|
@item LOG_ERR
|
|
|
|
The message describes an error.
|
|
|
|
@item LOG_WARNING
|
|
|
|
The message is a warning.
|
|
|
|
@item LOG_NOTICE
|
|
|
|
The message describes a normal but important event.
|
|
|
|
@item LOG_INFO
|
|
|
|
The message is purely informational.
|
|
|
|
@item LOG_DEBUG
|
|
|
|
The message is only for debugging purposes.
|
2001-02-11 20:15:00 +01:00
|
|
|
@end vtable
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
Results are undefined if the priority code is anything else.
|
|
|
|
|
[BZ #2510, BZ #2830, BZ #3137, BZ #3313, BZ #3426, BZ #3465, BZ #3480, BZ #3483, BZ #3493, BZ #3514, BZ #3515, BZ #3664, BZ #3673, BZ #3674]
2007-01-11 Jakub Jelinek <jakub@redhat.com>
* sysdeps/i386/soft-fp/sfp-machine.h: Remove.
* sysdeps/x86_64/soft-fp/sfp-machine.h: Likewise.
2007-01-10 Ulrich Drepper <drepper@redhat.com>
* io/fts.c: Make sure fts_cur is always valid after return from
fts_read.
Patch by Miloslav Trmac <mitr@redhat.com>.
2006-10-27 Richard Sandiford <richard@codesourcery.com>
* elf/elf.h (R_MIPS_GLOB_DAT): Define.
(R_MIPS_NUM): Bump by 1.
2007-01-03 Jakub Jelinek <jakub@redhat.com>
* posix/execvp.c: Include alloca.h.
(allocate_scripts_argv): Renamed to...
(scripts_argv): ... this. Don't allocate buffer here nor count
arguments.
(execvp): Use alloca if possible.
* posix/Makefile: Add rules to build and run tst-vfork3 test.
* posix/tst-vfork3.c: New test.
* stdlib/Makefile (tst-strtod3-ENV): Define.
2007-01-02 Ulrich Drepper <drepper@redhat.com>
* posix/getconf.c: Update copyright year.
* nss/getent.c: Likewise.
* iconv/iconvconfig.c: Likewise.
* iconv/iconv_prog.c: Likewise.
* elf/ldconfig.c: Likewise.
* catgets/gencat.c: Likewise.
* csu/version.c: Likewise.
* elf/ldd.bash.in: Likewise.
* elf/sprof.c (print_version): Likewise.
* locale/programs/locale.c: Likewise.
* locale/programs/localedef.c: Likewise.
* nscd/nscd.c (print_version): Likewise.
* debug/xtrace.sh: Likewise.
* malloc/memusage.sh: Likewise.
* malloc/mtrace.pl: Likewise.
* debug/catchsegv.sh: Likewise.
2006-12-24 Ulrich Drepper <drepper@redhat.com>
* malloc/malloc.c (sYSMALLOc): Remove some unnecessary alignment
attempts.
2006-12-23 Ulrich Drepper <drepper@redhat.com>
* posix/wordexp.c: Remove some unnecessary tests.
2006-12-20 SUGIOKA Toshinobu <sugioka@itonet.co.jp>
* sysdeps/unix/sysv/linux/sh/bits/shm.h: New file.
* nss/getXXbyYY_r.c: Include atomic.h.
(INTERNAL (REENTRANT_NAME)): Write startp after start_fct,
add atomic_write_barrier () in between.
2006-11-28 Jakub Jelinek <jakub@redhat.com>
* elf/dl-support.c: Include dl-procinfo.h.
* sysdeps/powerpc/dl-procinfo.h (PPC_PLATFORM_POWER4,
PPC_PLATFORM_PPC970, PPC_PLATFORM_POWER5, PPC_PLATFORM_POWER5_PLUS,
PPC_PLATFORM_POWER6, PPC_PLATFORM_CELL_BE, PPC_PLATFORM_POWER6X):
Define.
(_dl_string_platform): Use PPC_PLATFORM_* macros instead of
hardcoded constants.
* sysdeps/powerpc/dl-procinfo.c (_dl_powerpc_platform): Use
PPC_PLATFORM_* macros for array designators.
2006-11-11 Steven Munroe <sjmunroe@us.ibm.com>
* sysdeps/powerpc/dl-procinfo.c (_dl_powerpc_cap_flags): Add 3 new cap
names to the beginning.
(_dl_powerpc_platforms): Add "power6x".
* sysdeps/powerpc/dl-procinfo.h (_DL_HWCAP_FIRST): Decrease.
(HWCAP_IMPORTANT): Add PPC_FEATURE_HAS_DFP.
(_DL_PLATFORMS_COUNT): Increase.
(_dl_string_platform): Handle power6x case.
* sysdeps/powerpc/sysdep.h (PPC_FEATURE_PA6T, PPC_FEATURE_HAS_DFP,
PPC_FEATURE_POWER6_EXT): Define.
(PPC_FEATURE_POWER5, PPC_FEATURE_POWER5_PLUS): Correct Comment.
[-2^31 .. 2^31) range.
* sysdeps/unix/sysv/linux/bits/statvfs.h: Define ST_RELATIME.
* sysdeps/unix/sysv/linux/internal_statvfs.c (__statvfs_getflags):
Handle relatime mount option.
2006-12-13 Jakub Jelinek <jakub@redhat.com>
* sysdeps/unix/sysv/linux/powerpc/powerpc32/setcontext.S: Include
kernel-features.h.
2006-12-11 Ulrich Drepper <drepper@redhat.com>
* stdlib/strtod_l.c (____STRTOF_INTERNAL): Parse thousand
separators also if no non-zero digits found.
* stdlib/Makefile (tests): Add tst-strtod3.
[BZ #3664]
* stdlib/strtod_l.c (____STRTOF_INTERNAL): Fix test to recognize
empty parsed strings.
* stdlib/Makefile (tests): Add tst-strtod2.
* stdlib/tst-strtod2.c: New file.
[BZ #3673]
* stdlib/strtod_l.c (____STRTOF_INTERNAL): Fix exp_limit
computation.
* stdlib/Makefile (tests): Add tst-atof2.
* stdlib/tst-atof2.c: New file.
[BZ #3674]
* stdlib/strtod_l.c (____STRTOF_INTERNAL): Adjust exponent value
correctly if removing trailing zero of hex-float.
* stdlib/Makefile (tests): Add tst-atof1.
* stdlib/tst-atof1.c: New file.
* misc/mntent_r.c (__hasmntopt): Check p[optlen] even when p == rest.
Start searching for next comma at p rather than rest.
* misc/Makefile (tests): Add tst-mntent2.
* misc/tst-mntent2.c: New test.
2006-12-08 Ulrich Drepper <drepper@redhat.com>
* malloc/memusage.c: Handle realloc with new size of zero and
non-NULL pointer correctly.
(me): Really write first record twice.
(struct entry): Make format bi-arch safe.
(dest): Write out more realloc statistics.
* malloc/memusagestat.c (struct entry): Make format bi-arch safe.
2006-12-05 Jakub Jelinek <jakub@redhat.com>
* nis/nis_subr.c (nis_getnames): Revert last change.
2006-12-03 Kaz Kojima <kkojima@rr.iij4u.or.jp>
* sysdeps/unix/sysv/linux/sh/sys/io.h: Removed.
2006-11-30 H.J. Lu <hongjiu.lu@intel.com>
* sysdeps/i386/i686/memcmp.S: Use jump table as the base of
jump table entries.
2006-11-30 Jan Kratochvil <jan.kratochvil@redhat.com>
* sysdeps/unix/sysv/linux/i386/clone.S: Provide CFI for the outermost
`clone' function to ensure proper unwinding stop of gdb.
* sysdeps/unix/sysv/linux/x86_64/clone.S: Likewise.
2006-12-01 Ulrich Drepper <drepper@redhat.com>
* nscd/nscd.init: Remove obsolete and commented-out -S option
handling.
2006-11-23 Jakub Jelinek <jakub@redhat.com>
[BZ #3514]
* manual/string.texi (strncmp): Fix pastos from wcscmp description.
[BZ #3515]
* manual/string.texi (strtok): Remove duplicate paragraph.
2006-12-01 Jan Kratochvil <jan.kratochvil@redhat.com>
* sysdeps/unix/sysv/linux/x86_64/sigaction.c: Fix compatibility with
libgcc not supporting `rflags' unwinding (register # >= 17).
2006-11-30 Jakub Jelinek <jakub@redhat.com>
* sunrpc/svc_run.c (svc_run): Set my_pollfd to new_pollfd if realloc
succeeded.
2006-11-29 Daniel Jacobowitz <dan@codesourcery.com>
Jakub Jelinek <jakub@redhat.com>
Jan Kratochvil <jan.kratochvil@redhat.com>
* sysdeps/unix/sysv/linux/x86_64/sigaction.c (restore_rt): Add correct
unwind information.
* sysdeps/unix/sysv/linux/x86_64/Makefile: Provide symbols for
'restore_rt' even in the 'signal' directory.
* sysdeps/unix/sysv/linux/x86_64/ucontext_i.sym: Extend the regs list.
malloc crashed. Don't allocate memory unnecessarily in each
loop.
2006-10-21 Jakub Jelinek <jakub@redhat.com>
* resolv/mapv4v6addr.h (map_v4v6_address): Fix last change.
2006-11-20 Ulrich Drepper <drepper@redhat.com>
* resolv/mapv4v6addr.h (map_v4v6_address): Optimize a bit.
2006-11-18 Bruno Haible <bruno@clisp.org>
* sysdeps/unix/sysv/linux/i386/getgroups.c (__getgroups): Invoke
__sysconf only after having tried to call getgroups32.
2006-11-19 Ulrich Drepper <drepper@redhat.com>
* nss/nss_files/files-hosts.c (LINE_PARSER): Support IPv6-style
addresses for IPv4 queries if they can be mapped.
2006-11-16 Jakub Jelinek <jakub@redhat.com>
* sysdeps/x86_64/fpu/s_copysignf.S (__copysignf): Switch to .text.
* sysdeps/x86_64/fpu/s_copysign.S (__copysign): Likewise.
(signmask): Add .size directive.
(othermask): Add .type directive.
2006-11-14 Ulrich Drepper <drepper@redhat.com>
* po/nl.po: Update from translation team.
* timezone/zdump.c: Redo fix for BZ #3137.
2006-11-14 Jakub Jelinek <jakub@redhat.com>
* nss/nss_files/files-alias.c (get_next_alias): Set line back
to first_unused after parsing :include: file.
* timezone/africa: Update from tzdata2006o.
* timezone/antarctica: Likewise.
* timezone/asia: Likewise.
* timezone/australasia: Likewise.
* timezone/backward: Likewise.
* timezone/europe: Likewise.
* timezone/iso3166.tab: Likewise.
* timezone/northamerica: Likewise.
* timezone/southamerica: Likewise.
* timezone/zone.tab: Likewise.
* time/tzfile.c (__tzfile_read): Extend to handle new file format
on machines with 64-bit time_t.
* timezone/checktab.awk: Update from tzcode2006o.
* timezone/ialloc.c: Likewise.
* timezone/private.h: Likewise.
* timezone/scheck.c: Likewise.
* timezone/tzfile.h: Likewise.
* timezone/tzselect.ksh: Likewise.
* timezone/zdump.c: Likewise.
* timezone/zic.c: Likewise.
[BZ #3483]
* elf/ldconfig.c (main): Call setlocale and textdomain.
Patch mostly by Benno Schulenberg <bensberg@justemail.net>.
[BZ #3480]
* manual/argp.texi: Fix typos.
* manual/charset.texi: Likewise.
* manual/errno.texi: Likewise.
* manual/filesys.texi: Likewise.
* manual/lang.texi: Likewise.
* manual/maint.texi: Likewise.
* manual/memory.texi: Likewise.
* manual/message.texi: Likewise.
* manual/resource.texi: Likewise.
* manual/search.texi: Likewise.
* manual/signal.texi: Likewise.
* manual/startup.texi: Likewise.
* manual/stdio.texi: Likewise.
* manual/sysinfo.texi: Likewise.
* manual/syslog.texi: Likewise.
* manual/time.texi: Likewise.
Patch by Ralf Wildenhues <Ralf.Wildenhues@gmx.de>.
[BZ #3465]
* sunrpc/clnt_raw.c: Minimal message improvements.
* sunrpc/pm_getmaps.c: Likewise.
* nis/nss_nisplus/nisplus-publickey.c: Likewise.
* nis/nis_print_group_entry.c: Likewise.
* locale/programs/repertoire.c: Likewise.
* locale/programs/charmap.c: Likewise.
* malloc/memusage.sh: Likewise.
* elf/dl-deps.c: Likewise.
* locale/programs/ld-collate.c: Likewise.
* libio/vswprintf.c: Likewise.
* malloc/memusagestat.c: Likewise.
* sunrpc/auth_unix.c: Likewise.
* sunrpc/rpc_main.c: Likewise.
* nscd/cache.c: Likewise.
* locale/programs/repertoire.c: Unify output messages.
* locale/programs/charmap.c: Likewise.
* locale/programs/ld-ctype.c: Likewise.
* locale/programs/ld-monetary.c: Likewise.
* locale/programs/ld-numeric.c: Likewise.
* locale/programs/ld-time.c: Likewise.
* elf/ldconfig.c: Likewise.
* nscd/selinux.c: Likewise.
* elf/cache.c: Likewise.
Patch mostly by Benno Schulenberg <bensberg@justemail.net>.
2006-11-10 Jakub Jelinek <jakub@redhat.com>
* string/strxfrm_l.c (STRXFRM): Fix trailing \1 optimization
if N is one bigger than return value.
* string/tst-strxfrm2.c (do_test): Also test strxfrm with l1 + 1
and l1 last arguments, if buf is defined, verify the return value
equals to strlen (buf) and verify no byte beyond passed length
is modified.
2006-11-10 Ulrich Drepper <drepper@redhat.com>
* po/sv.po: Update from translation team.
* sysdeps/gnu/siglist.c (__old_sys_siglist, __old_sys_sigabbrev):
Use __new_sys_siglist instead of _sys_siglist_internal as
second macro argument.
(_old_sys_siglist): Use declare_symbol_alias macro instead of
strong_alias.
2006-11-09 Ulrich Drepper <drepper@redhat.com>
[BZ #3493]
* posix/unistd.h (sysconf): Remove const attribute.
* sysdeps/posix/getaddrinfo.c (getaddrinfo): Fix test for
temporary or deprecated addresses.
Patch by Sridhar Samudrala <sri@us.ibm.com>.
* string/Makefile (tests): Add tst-strxfrm2.
* string/tst-strxfrm2.c: New file.
2006-10-09 Jakub Jelinek <jakub@redhat.com>
* elf/dl-debug.c (_dl_debug_initialize): Check r->r_map for 0
rather than r->r_brk.
* string/strxfrm_l.c (STRXFRM): Do the trailing \1 removal
optimization even if needed > n.
2006-11-07 Jakub Jelinek <jakub@redhat.com>
* include/libc-symbols.h (declare_symbol): Rename to...
(declare_symbol_alias): ... this. Add ORIGINAL argument, imply
strong_alias (ORIGINAL, SYMBOL) in asm to make sure it preceedes
.size directive.
* sysdeps/gnu/errlist-compat.awk: Adjust for declare_symbol_alias
changes.
* sysdeps/gnu/siglist.c: Likewise.
2006-11-03 Steven Munroe <sjmunroe@us.ibm.com>
* sysdeps/powerpc/fpu/bits/mathinline.h
[__LIBC_INTERNAL_MATH_INLINES]: Moved to ...
* sysdeps/powerpc/fpu/math_private.h: ...here. New file.
2006-11-05 Ulrich Drepper <drepper@redhat.com>
* sysdeps/unix/sysv/linux/i386/sysconf.c (intel_check_word):
Update handling of cache descriptor 0x49 for new models.
* sysdeps/unix/sysv/linux/x86_64/sysconf.c (intel_check_word):
Likewise.
2006-11-02 Ulrich Drepper <drepper@redhat.com>
* configure.in: Work around ld --help change and avoid -z relro
test completely if the architecture doesn't care about security.
2006-11-01 Ulrich Drepper <drepper@redhat.com>
* po/sv.po: Update from translation team.
2006-10-31 Ulrich Drepper <drepper@redhat.com>
* stdlib/atexit.c (atexit): Don't mark as hidden when used to
generate compatibility version.
2006-10-29 Ulrich Drepper <drepper@redhat.com>
* configure.in: Relax -z relro requirement a bit.
* po/sv.po: Update from translation team.
2006-10-29 Jakub Jelinek <jakub@redhat.com>
* elf/dl-sym.c (do_sym): Use RTLD_SINGLE_THREAD_P.
* elf/dl-runtime.c (_dl_fixup, _dl_profile_fixup): Likewise.
* elf/dl-close.c (_dl_close_worker): Likewise.
* elf/dl-open.c (_dl_open_worker): Likewise.
* sysdeps/generic/sysdep-cancel.h (RTLD_SINGLE_THREAD_P): Define.
* configure.in: Require assembler support for visibility, compiler
support for visibility and aliases, linker support for various -z
options.
* Makeconfig: Remove conditional code which now is unnecessary.
* config.h.in: Likewise.
* config.make.in: Likewise.
* dlfcn/Makefile: Likewise.
* elf/Makefile: Likewise.
* elf/dl-load.c: Likewise.
* elf/rtld.c: Likewise.
* include/libc-symbols.h: Likewise.
* include/stdio.h: Likewise.
* io/Makefile: Likewise.
* io/fstat.c: Likewise.
* io/fstat64.c: Likewise.
* io/fstatat.c: Likewise.
* io/fstatat64.c: Likewise.
* io/lstat.c: Likewise.
* io/lstat64.c: Likewise.
* io/mknod.c: Likewise.
* io/mknodat.c: Likewise.
* io/stat.c: Likewise.
* io/stat64.c: Likewise.
* libio/stdio.c: Likewise.
* nscd/Makefile: Likewise.
* stdlib/Makefile: Likewise.
* stdlib/atexit.c: Likewise.
* sysdeps/generic/ldsodefs.h: Likewise.
* sysdeps/i386/dl-machine.h: Likewise.
* sysdeps/i386/sysdep.h: Likewise.
* sysdeps/i386/i686/memcmp.S: Likewise.
* sysdeps/powerpc/powerpc32/sysdep.h: Likewise.
* sysdeps/unix/sysv/linux/i386/sigaction.c: Likewise.
* sysdeps/unix/sysv/linux/x86_64/sigaction.c: Likewise.
* Makerules: USE_TLS support is now default.
* tls.make.c: Likewise.
* csu/Versions: Likewise.
* csu/libc-start.c: Likewise.
* csu/libc-tls.c: Likewise.
* csu/version.c: Likewise.
* dlfcn/dlinfo.c: Likewise.
* elf/dl-addr.c: Likewise.
* elf/dl-cache.c: Likewise.
* elf/dl-close.c: Likewise.
* elf/dl-iteratephdr.c: Likewise.
* elf/dl-load.c: Likewise.
* elf/dl-lookup.c: Likewise.
* elf/dl-object.c: Likewise.
* elf/dl-open.c: Likewise.
* elf/dl-reloc.c: Likewise.
* elf/dl-support.c: Likewise.
* elf/dl-sym.c: Likewise.
* elf/dl-sysdep.c: Likewise.
* elf/dl-tls.c: Likewise.
* elf/ldconfig.c: Likewise.
* elf/rtld.c: Likewise.
* elf/tst-tls-dlinfo.c: Likewise.
* elf/tst-tls1.c: Likewise.
* elf/tst-tls10.h: Likewise.
* elf/tst-tls14.c: Likewise.
* elf/tst-tls2.c: Likewise.
* elf/tst-tls3.c: Likewise.
* elf/tst-tls4.c: Likewise.
* elf/tst-tls5.c: Likewise.
* elf/tst-tls6.c: Likewise.
* elf/tst-tls7.c: Likewise.
* elf/tst-tls8.c: Likewise.
* elf/tst-tls9.c: Likewise.
* elf/tst-tlsmod1.c: Likewise.
* elf/tst-tlsmod13.c: Likewise.
* elf/tst-tlsmod13a.c: Likewise.
* elf/tst-tlsmod14a.c: Likewise.
* elf/tst-tlsmod2.c: Likewise.
* elf/tst-tlsmod3.c: Likewise.
* elf/tst-tlsmod4.c: Likewise.
* elf/tst-tlsmod5.c: Likewise.
* elf/tst-tlsmod6.c: Likewise.
* include/errno.h: Likewise.
* include/link.h: Likewise.
* include/tls.h: Likewise.
* locale/global-locale.c: Likewise.
* locale/localeinfo.h: Likewise.
* malloc/arena.c: Likewise.
* malloc/hooks.c: Likewise.
* malloc/malloc.c: Likewise.
* resolv/Versions: Likewise.
* sysdeps/alpha/dl-machine.h: Likewise.
* sysdeps/alpha/libc-tls.c: Likewise.
* sysdeps/generic/ldsodefs.h: Likewise.
* sysdeps/generic/tls.h: Likewise.
* sysdeps/i386/dl-machine.h: Likewise.
* sysdeps/ia64/dl-machine.h: Likewise.
* sysdeps/ia64/libc-tls.c: Likewise.
* sysdeps/mach/hurd/fork.c: Likewise.
* sysdeps/mach/hurd/i386/tls.h: Likewise.
* sysdeps/powerpc/powerpc32/dl-machine.c: Likwise.
* sysdeps/powerpc/powerpc32/dl-machine.h: Likewise.
* sysdeps/powerpc/powerpc64/dl-machine.h: Likewise.
* sysdeps/s390/libc-tls.c: Likewise.
* sysdeps/s390/s390-32/dl-machine.h: Likewise.
* sysdeps/s390/s390-64/dl-machine.h: Likewise.
* sysdeps/sh/dl-machine.h: Likewise.
* sysdeps/sparc/sparc32/dl-machine.h: Likewise.
* sysdeps/sparc/sparc64/dl-machine.h: Likewise.
* sysdeps/x86_64/dl-machine.h: Likewise.
[BZ #3426]
* stdlib/stdlib.h: Adjust comment for canonicalize_file_name to
reality.
2006-10-27 Jakub Jelinek <jakub@redhat.com>
* elf/dl-lookup.c (_dl_debug_bindings): Remove unused symbol_scope
argument.
(_dl_lookup_symbol_x): Adjust caller.
* sysdeps/generic/ldsodefs.h (struct link_namespaces): Remove
_ns_global_scope.
* elf/rtld.c (dl_main): Don't initialize _ns_global_scope.
* elf/dl-libc.c: Revert l_scope name changes.
* elf/dl-load.c: Likewise.
* elf/dl-object.c: Likewise.
* elf/rtld.c: Likewise.
* elf/dl-close.c (_dl_close): Likewise.
* elf/dl-open.c (dl_open_worker): Likewise. If not SINGLE_THREAD_P,
always use __rtld_mrlock_{change,done}. Always free old scope list
here if not l_scope_mem.
* elf/dl-runtime.c (_dl_fixup, _dl_profile_fixup): Revert l_scope name
change. Never free scope list here. Just __rtld_mrlock_lock before
the lookup and __rtld_mrlock_unlock it after the lookup.
* elf/dl-sym.c: Likewise.
* include/link.h (struct r_scoperec): Remove.
(struct link_map): Replace l_scoperec with l_scope, l_scoperec_mem
with l_scope_mem and l_scoperec_lock with l_scope_lock.
2006-10-25 Ulrich Drepper <drepper@redhat.com>
* sysdeps/gnu/netinet/tcp.h: Define TCP_CONGESTION.
2006-10-18 Ulrich Drepper <drepper@redhat.com>
* configure.in: Disable building profile libraries by default.
2006-10-18 Ulrich Drepper <drepper@redhat.com>
* elf/dl-lookup.c (_dl_lookup_symbol_x): Add warning to
_dl_lookup_symbol_x code.
2006-10-17 Jakub Jelinek <jakub@redhat.com>
* elf/dl-runtime.c: Include sysdep-cancel.h.
(_dl_fixup, _dl_profile_fixup): Use __rtld_mrlock_* and
scoperec->nusers only if !SINGLE_THREAD_P. Use atomic_*
instead of catomic_* macros.
* elf/dl-sym.c: Include sysdep-cancel.h.
(do_sym): Use __rtld_mrlock_* and scoperec->nusers only
if !SINGLE_THREAD_P. Use atomic_* instead of catomic_* macros.
* elf/dl-close.c: Include sysdep-cancel.h.
(_dl_close): Use __rtld_mrlock_* and scoperec->nusers only
if !SINGLE_THREAD_P. Use atomic_* instead of catomic_* macros.
* elf/dl-open.c: Include sysdep-cancel.h.
(dl_open_worker): Use __rtld_mrlock_* and scoperec->nusers only
if !SINGLE_THREAD_P. Use atomic_* instead of catomic_* macros.
2006-10-17 Jakub Jelinek <jakub@redhat.com>
[BZ #3313]
* malloc/malloc.c (malloc_consolidate): Set maxfb to address of last
fastbin rather than end of fastbin array.
2006-10-18 Ulrich Drepper <drepper@redhat.com>
* sysdeps/i386/i486/bits/atomic.h (catomic_decrement): Use correct
body macro.
* sysdeps/x86_64/bits/atomic.h
(__arch_c_compare_and_exchange_val_64_acq): Add missing casts.
(catomic_decrement): Use correct body macro.
2006-10-17 Jakub Jelinek <jakub@redhat.com>
* include/atomic.h: Add a unique prefix to all local variables
in macros.
* csu/tst-atomic.c (do_test): Test also catomic_* macros.
2006-10-14 Ulrich Drepper <drepper@redhat.com>
* resolv/arpa/nameser.h: Document that ns_t_a6 is deprecated.
[BZ #3313]
* malloc/malloc.c (malloc_consolidate): Don't use get_fast_max to
determine highest fast bin to consolidate, always look into all of
them.
(do_check_malloc_state): Only require for empty bins for large
sizes in main arena.
* libio/stdio.h: Add more __wur attributes.
2006-11-12 Andreas Jaeger <aj@suse.de>
[BZ #2510]
* manual/search.texi (Hash Search Function): Clarify.
(Array Search Function): Clarify.
2006-11-12 Joseph Myers <joseph@codesourcery.com>
[BZ #2830]
* math/atest-exp.c (main): Cast hex value to mp_limb_t before
shifting.
* math/atest-exp2.c (read_mpn_hex): Likewise.
* math/atest-sincos.c (main): Likewise.
* sysdeps/unix/sysv/linux/syscalls.list: Add epoll_pwait.
* sysdeps/unix/sysv/linux/sys/epoll.h: Declare epoll_pwait.
* sysdeps/unix/sysv/linux/Versions (libc): Add epoll_pwait for
version GLIBC_2.6.
* Versions.def: Add GLIBC_2.6 for libc.
* sysdeps/i386/i486/bits/atomic.h: Add catomic_* support.
2006-10-11 Jakub Jelinek <jakub@redhat.com>
* malloc/malloc.c (_int_malloc): Remove unused any_larger variable.
* nis/nis_defaults.c (__nis_default_access): Don't call getenv twice.
* nis/nis_subr.c (nis_getnames): Use __secure_getenv instead of getenv.
* sysdeps/generic/unsecvars.h: Add NIS_PATH.
2006-10-11 Ulrich Drepper <drepper@redhat.com>
* include/atomic.c: Define catomic_* operations.
* sysdeps/x86_64/bits/atomic.h: Likewise. Fix a few minor problems.
* stdlib/cxa_finalize.c: Use catomic_* operations instead of atomic_*.
* malloc/memusage.c: Likewise.
* gmon/mcount.c: Likewise.
* elf/dl-close.c: Likewise.
* elf/dl-open.c: Likewise.
* elf/dl-profile.c: Likewise.
* elf/dl-sym.c: Likewise.
* elf/dl-runtime.c: Likewise.
* elf/dl-fptr.c: Likewise.
* resolv/res_libc.c: Likewise.
2006-10-10 Roland McGrath <roland@frob.com>
* sysdeps/mach/hurd/utimes.c: Use a union to avoid an improper cast.
* sysdeps/mach/hurd/futimes.c: Likewise.
* sysdeps/mach/hurd/lutimes.c: Likewise.
2006-10-09 Ulrich Drepper <drepper@redhat.com>
Jakub Jelinek <jakub@redhat.com>
Implement reference counting of scope records.
* elf/dl-close.c (_dl_close): Remove all scopes from removed objects
from the list in objects which remain. Always allocate new scope
record.
* elf/dl-open.c (dl_open_worker): When growing array for scopes,
don't resize, allocate a new one.
* elf/dl-runtime.c: Update reference counters before using a scope
array.
* elf/dl-sym.c: Likewise.
* elf/dl-libc.c: Adjust for l_scope name change.
* elf/dl-load.c: Likewise.
* elf/dl-object.c: Likewise.
* elf/rtld.c: Likewise.
* include/link.h: Include <rtld-lowlevel.h>. Define struct
r_scoperec. Replace r_scope with pointer to r_scoperec structure.
Add l_scoperec_lock.
* sysdeps/generic/ldsodefs.h: Include <rtld-lowlevel.h>.
* sysdeps/generic/rtld-lowlevel.h: New file.
* include/atomic.h: Rename atomic_and to atomic_and_val and
atomic_or to atomic_or_val. Define new macros atomic_and and
atomic_or which do not return values.
* sysdeps/x86_64/bits/atomic.h: Define atomic_and and atomic_or.
Various cleanups.
* sysdeps/i386/i486/bits/atomic.h: Likewise.
* po/sv.po: Update from translation team.
2006-10-07 Ulrich Drepper <drepper@redhat.com>
* Versions.def: Add GLIBC_2.6 to libpthread.
* include/shlib-compat.h (SHLIB_COMPAT): Expand parameters before use.
(versioned_symbol): Likewise.
(compat_symbol): Likewise.
* po/tr.po: Update from translation team.
* nis/Banner: Removed. It's been integral part forever and the
author info is incomplete anyway.
* libio/Banner: Likewise.
2006-10-06 Ulrich Drepper <drepper@redhat.com>
* version.h (VERSION): Bump to 2.5.90 for new development tree.
2007-01-11 22:51:07 +01:00
|
|
|
If the process does not presently have a Syslog connection open (i.e.,
|
2000-04-24 05:55:14 +02:00
|
|
|
it did not call @code{openlog}), @code{syslog} implicitly opens the
|
|
|
|
connection the same as @code{openlog} would, with the following defaults
|
|
|
|
for information that would otherwise be included in an @code{openlog}
|
|
|
|
call: The default identification string is the program name. The
|
|
|
|
default default facility is @code{LOG_USER}. The default for all the
|
|
|
|
connection options in @var{options} is as if those bits were off.
|
|
|
|
@code{syslog} leaves the Syslog connection open.
|
|
|
|
|
|
|
|
If the @file{dev/log} socket is not open and connected, @code{syslog}
|
|
|
|
opens and connects it, the same as @code{openlog} with the
|
|
|
|
@code{LOG_NDELAY} option would.
|
|
|
|
|
|
|
|
@code{syslog} leaves @file{/dev/log} open and connected unless its attempt
|
|
|
|
to send the message failed, in which case @code{syslog} closes it (with the
|
|
|
|
hope that a future implicit open will restore the Syslog connection to a
|
|
|
|
usable state).
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
|
|
|
|
#include <syslog.h>
|
2001-02-11 20:15:00 +01:00
|
|
|
syslog (LOG_MAKEPRI(LOG_LOCAL1, LOG_ERROR),
|
|
|
|
"Unable to make network connection to %s. Error=%m", host);
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
@end deftypefun
|
|
|
|
|
|
|
|
|
|
|
|
@comment syslog.h
|
|
|
|
@comment BSD
|
2012-02-17 18:44:38 +01:00
|
|
|
@deftypefun void vsyslog (int @var{facility_priority}, char *@var{format}, va_list @var{arglist})
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
This is functionally identical to @code{syslog}, with the BSD style variable
|
|
|
|
length argument.
|
|
|
|
|
|
|
|
@end deftypefun
|
|
|
|
|
|
|
|
|
|
|
|
@node closelog
|
|
|
|
@subsection closelog
|
|
|
|
|
|
|
|
The symbols referred to in this section are declared in the file
|
|
|
|
@file{syslog.h}.
|
|
|
|
|
|
|
|
@comment syslog.h
|
|
|
|
@comment BSD
|
2001-02-11 20:15:00 +01:00
|
|
|
@deftypefun void closelog (void)
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@code{closelog} closes the current Syslog connection, if there is one.
|
2002-01-18 07:26:02 +01:00
|
|
|
This includes closing the @file{dev/log} socket, if it is open.
|
|
|
|
@code{closelog} also sets the identification string for Syslog messages
|
|
|
|
back to the default, if @code{openlog} was called with a non-NULL argument
|
|
|
|
to @var{ident}. The default identification string is the program name
|
|
|
|
taken from argv[0].
|
|
|
|
|
|
|
|
If you are writing shared library code that uses @code{openlog} to
|
2012-02-28 15:44:20 +01:00
|
|
|
generate custom syslog output, you should use @code{closelog} to drop
|
|
|
|
@theglibc{}'s internal reference to the @var{ident} pointer when you are
|
2002-01-18 07:26:02 +01:00
|
|
|
done. Please read the section on @code{openlog} for more information:
|
|
|
|
@xref{openlog}.
|
|
|
|
|
|
|
|
@code{closelog} does not flush any buffers. You do not have to call
|
2012-04-08 15:00:50 +02:00
|
|
|
@code{closelog} before re-opening a Syslog connection with @code{openlog}.
|
2002-01-18 07:26:02 +01:00
|
|
|
Syslog connections are automatically closed on exec or exit.
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@end deftypefun
|
|
|
|
|
|
|
|
|
|
|
|
@node setlogmask
|
|
|
|
@subsection setlogmask
|
|
|
|
|
|
|
|
The symbols referred to in this section are declared in the file
|
|
|
|
@file{syslog.h}.
|
|
|
|
|
|
|
|
@comment syslog.h
|
|
|
|
@comment BSD
|
|
|
|
@deftypefun int setlogmask (int @var{mask})
|
|
|
|
|
|
|
|
@code{setlogmask} sets a mask (the ``logmask'') that determines which
|
|
|
|
future @code{syslog} calls shall be ignored. If a program has not
|
|
|
|
called @code{setlogmask}, @code{syslog} doesn't ignore any calls. You
|
|
|
|
can use @code{setlogmask} to specify that messages of particular
|
|
|
|
priorities shall be ignored in the future.
|
|
|
|
|
|
|
|
A @code{setlogmask} call overrides any previous @code{setlogmask} call.
|
|
|
|
|
|
|
|
Note that the logmask exists entirely independently of opening and
|
|
|
|
closing of Syslog connections.
|
|
|
|
|
|
|
|
Setting the logmask has a similar effect to, but is not the same as,
|
|
|
|
configuring Syslog. The Syslog configuration may cause Syslog to
|
|
|
|
discard certain messages it receives, but the logmask causes certain
|
|
|
|
messages never to get submitted to Syslog in the first place.
|
|
|
|
|
|
|
|
@var{mask} is a bit string with one bit corresponding to each of the
|
|
|
|
possible message priorities. If the bit is on, @code{syslog} handles
|
|
|
|
messages of that priority normally. If it is off, @code{syslog}
|
|
|
|
discards messages of that priority. Use the message priority macros
|
|
|
|
described in @ref{syslog; vsyslog} and the @code{LOG_MASK} to construct
|
|
|
|
an appropriate @var{mask} value, as in this example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
LOG_MASK(LOG_EMERG) | LOG_MASK(LOG_ERROR)
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
~(LOG_MASK(LOG_INFO))
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
There is also a @code{LOG_UPTO} macro, which generates a mask with the bits
|
|
|
|
on for a certain priority and all priorities above it:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
LOG_UPTO(LOG_ERROR)
|
|
|
|
@end smallexample
|
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
The unfortunate naming of the macro is due to the fact that internally,
|
2000-04-24 05:55:14 +02:00
|
|
|
higher numbers are used for lower message priorities.
|
|
|
|
|
|
|
|
@end deftypefun
|
|
|
|
|
|
|
|
|
|
|
|
@node Syslog Example
|
|
|
|
@subsection Syslog Example
|
|
|
|
|
|
|
|
Here is an example of @code{openlog}, @code{syslog}, and @code{closelog}:
|
|
|
|
|
|
|
|
This example sets the logmask so that debug and informational messages
|
|
|
|
get discarded without ever reaching Syslog. So the second @code{syslog}
|
|
|
|
in the example does nothing.
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
#include <syslog.h>
|
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
setlogmask (LOG_UPTO (LOG_NOTICE));
|
2000-04-24 05:55:14 +02:00
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
openlog ("exampleprog", LOG_CONS | LOG_PID | LOG_NDELAY, LOG_LOCAL1);
|
2000-04-24 05:55:14 +02:00
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
syslog (LOG_NOTICE, "Program started by User %d", getuid ());
|
|
|
|
syslog (LOG_INFO, "A tree falls in a forest");
|
2000-04-24 05:55:14 +02:00
|
|
|
|
2001-02-11 20:15:00 +01:00
|
|
|
closelog ();
|
2000-04-24 05:55:14 +02:00
|
|
|
|
|
|
|
@end smallexample
|