]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/sys/syslog.h
xnu-6153.61.1.tar.gz
[apple/xnu.git] / bsd / sys / syslog.h
index 1444f54b1ad639109ce830e943ba045870651d35..facf1c036ecef5afd4d6810bf2b792d4726defa1 100644 (file)
@@ -1,34 +1,32 @@
 /*
 /*
- * Copyright (c) 2006 Apple Computer, Inc. All Rights Reserved.
- * 
- * @APPLE_LICENSE_OSREFERENCE_HEADER_START@
- * 
- * This file contains Original Code and/or Modifications of Original Code 
- * as defined in and that are subject to the Apple Public Source License 
- * Version 2.0 (the 'License'). You may not use this file except in 
- * compliance with the License.  The rights granted to you under the 
- * License may not be used to create, or enable the creation or 
- * redistribution of, unlawful or unlicensed copies of an Apple operating 
- * system, or to circumvent, violate, or enable the circumvention or 
- * violation of, any terms of an Apple operating system software license 
- * agreement.
+ * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
  *
  *
- * Please obtain a copy of the License at 
- * http://www.opensource.apple.com/apsl/ and read it before using this 
- * file.
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
  *
  *
- * The Original Code and all software distributed under the License are 
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
- * Please see the License for the specific language governing rights and 
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ *
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ *
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
  * limitations under the License.
  *
  * limitations under the License.
  *
- * @APPLE_LICENSE_OSREFERENCE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  */
 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
  */
 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
-/*
+/*-
  * Copyright (c) 1982, 1986, 1988, 1993
  *     The Regents of the University of California.  All rights reserved.
  *
  * Copyright (c) 1982, 1986, 1988, 1993
  *     The Regents of the University of California.  All rights reserved.
  *
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
  *    documentation and/or other materials provided with the distribution.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
  *    documentation and/or other materials provided with the distribution.
- * 3. All advertising materials mentioning features or use of this software
- *    must display the following acknowledgement:
- *     This product includes software developed by the University of
- *     California, Berkeley and its contributors.
  * 4. Neither the name of the University nor the names of its contributors
  *    may be used to endorse or promote products derived from this software
  *    without specific prior written permission.
  * 4. Neither the name of the University nor the names of its contributors
  *    may be used to endorse or promote products derived from this software
  *    without specific prior written permission.
  * SUCH DAMAGE.
  *
  *     @(#)syslog.h    8.1 (Berkeley) 6/2/93
  * SUCH DAMAGE.
  *
  *     @(#)syslog.h    8.1 (Berkeley) 6/2/93
+ * $FreeBSD: src/sys/sys/syslog.h,v 1.27.2.1.4.1 2010/06/14 02:09:06 kensmith Exp $
  */
 
  */
 
-#ifndef        _SYS_SYSLOG_H_
+#ifndef _SYS_SYSLOG_H_
 #define _SYS_SYSLOG_H_
 
 #include <sys/appleapiopts.h>
 #include <sys/cdefs.h>
 
 #define _SYS_SYSLOG_H_
 
 #include <sys/appleapiopts.h>
 #include <sys/cdefs.h>
 
-#define        _PATH_LOG       "/var/run/syslog"
+#define _PATH_LOG       "/var/run/syslog"
 
 /*
  * priorities/facilities are encoded into a single 32-bit quantity, where the
 
 /*
  * priorities/facilities are encoded into a single 32-bit quantity, where the
  *
  * priorities (these are ordered)
  */
  *
  * priorities (these are ordered)
  */
-#define        LOG_EMERG       0       /* system is unusable */
-#define        LOG_ALERT       1       /* action must be taken immediately */
-#define        LOG_CRIT        2       /* critical conditions */
-#define        LOG_ERR         3       /* error conditions */
-#define        LOG_WARNING     4       /* warning conditions */
-#define        LOG_NOTICE      5       /* normal but significant condition */
-#define        LOG_INFO        6       /* informational */
-#define        LOG_DEBUG       7       /* debug-level messages */
+#define LOG_EMERG       0       /* system is unusable */
+#define LOG_ALERT       1       /* action must be taken immediately */
+#define LOG_CRIT        2       /* critical conditions */
+#define LOG_ERR         3       /* error conditions */
+#define LOG_WARNING     4       /* warning conditions */
+#define LOG_NOTICE      5       /* normal but significant condition */
+#define LOG_INFO        6       /* informational */
+#define LOG_DEBUG       7       /* debug-level messages */
 
 
-#define        LOG_PRIMASK     0x07    /* mask to extract priority part (internal) */
-                               /* extract priority */
-#define        LOG_PRI(p)      ((p) & LOG_PRIMASK)
-#define        LOG_MAKEPRI(fac, pri)   (((fac) << 3) | (pri))
+#define LOG_PRIMASK     0x07    /* mask to extract priority part (internal) */
+/* extract priority */
+#define LOG_PRI(p)      ((p) & LOG_PRIMASK)
+#define LOG_MAKEPRI(fac, pri)   ((fac) | (pri))
 
 #ifdef SYSLOG_NAMES
 
 #ifdef SYSLOG_NAMES
-#define        INTERNAL_NOPRI  0x10    /* the "no priority" priority */
-                               /* mark "facility" */
-#define        INTERNAL_MARK   LOG_MAKEPRI(LOG_NFACILITIES, 0)
+#define INTERNAL_NOPRI  0x10    /* the "no priority" priority */
+/* mark "facility" */
+#define INTERNAL_MARK   LOG_MAKEPRI((LOG_NFACILITIES<<3), 0)
 typedef struct _code {
 typedef struct _code {
-       char    *c_name;
-       int     c_val;
+       const char      *c_name;
+       int             c_val;
 } CODE;
 
 CODE prioritynames[] = {
 } CODE;
 
 CODE prioritynames[] = {
-       { "alert",      LOG_ALERT },
-       { "crit",       LOG_CRIT },
-       { "debug",      LOG_DEBUG },
-       { "emerg",      LOG_EMERG },
-       { "err",        LOG_ERR },
-       { "error",      LOG_ERR },              /* DEPRECATED */
-       { "info",       LOG_INFO },
-       { "none",       INTERNAL_NOPRI },       /* INTERNAL */
-       { "notice",     LOG_NOTICE },
-       { "panic",      LOG_EMERG },            /* DEPRECATED */
-       { "warn",       LOG_WARNING },          /* DEPRECATED */
-       { "warning",    LOG_WARNING },
-       { 0,            -1 }
+       { "alert", LOG_ALERT, },
+       { "crit", LOG_CRIT, },
+       { "debug", LOG_DEBUG, },
+       { "emerg", LOG_EMERG, },
+       { "err", LOG_ERR, },
+       { "error", LOG_ERR, },                  /* DEPRECATED */
+       { "info", LOG_INFO, },
+       { "none", INTERNAL_NOPRI, },            /* INTERNAL */
+       { "notice", LOG_NOTICE, },
+       { "panic", LOG_EMERG, },                /* DEPRECATED */
+       { "warn", LOG_WARNING, },               /* DEPRECATED */
+       { "warning", LOG_WARNING, },
+       { NULL, -1, }
 };
 #endif
 
 /* facility codes */
 };
 #endif
 
 /* facility codes */
-#define        LOG_KERN                (0<<3)  /* kernel messages */
-#define        LOG_USER                (1<<3)  /* random user-level messages */
-#define        LOG_MAIL                (2<<3)  /* mail system */
-#define        LOG_DAEMON              (3<<3)  /* system daemons */
-#define        LOG_AUTH                (4<<3)  /* security/authorization messages */
-#define        LOG_SYSLOG              (5<<3)  /* messages generated internally by syslogd */
-#define        LOG_LPR                 (6<<3)  /* line printer subsystem */
-#define        LOG_NEWS                (7<<3)  /* network news subsystem */
-#define        LOG_UUCP                (8<<3)  /* UUCP subsystem */
-#define        LOG_CRON                (9<<3)  /* clock daemon */
-#define        LOG_AUTHPRIV    (10<<3) /* security/authorization messages (private) */
-#define        LOG_FTP                 (11<<3) /* ftp daemon */
-#define        LOG_NETINFO             (12<<3) /* NetInfo */
-#define        LOG_REMOTEAUTH  (13<<3) /* remote authentication/authorization */
-#define        LOG_INSTALL             (14<<3) /* installer subsystem */
-#define        LOG_RAS                 (15<<3) /* Remote Access Service (VPN / PPP) */
+#define LOG_KERN        (0<<3)  /* kernel messages */
+#define LOG_USER        (1<<3)  /* random user-level messages */
+#define LOG_MAIL        (2<<3)  /* mail system */
+#define LOG_DAEMON      (3<<3)  /* system daemons */
+#define LOG_AUTH        (4<<3)  /* authorization messages */
+#define LOG_SYSLOG      (5<<3)  /* messages generated internally by syslogd */
+#define LOG_LPR         (6<<3)  /* line printer subsystem */
+#define LOG_NEWS        (7<<3)  /* network news subsystem */
+#define LOG_UUCP        (8<<3)  /* UUCP subsystem */
+#define LOG_CRON        (9<<3)  /* clock daemon */
+#define LOG_AUTHPRIV    (10<<3) /* authorization messages (private) */
+/* Facility #10 clashes in DEC UNIX, where */
+/* it's defined as LOG_MEGASAFE for AdvFS  */
+/* event logging.                          */
+#define LOG_FTP         (11<<3) /* ftp daemon */
+//#define      LOG_NTP         (12<<3) /* NTP subsystem */
+//#define      LOG_SECURITY    (13<<3) /* security subsystems (firewalling, etc.) */
+//#define      LOG_CONSOLE     (14<<3) /* /dev/console output */
+#define LOG_NETINFO     (12<<3) /* NetInfo */
+#define LOG_REMOTEAUTH  (13<<3) /* remote authentication/authorization */
+#define LOG_INSTALL     (14<<3) /* installer subsystem */
+#define LOG_RAS         (15<<3) /* Remote Access Service (VPN / PPP) */
 
 
-#define        LOG_LOCAL0      (16<<3) /* reserved for local use */
-#define        LOG_LOCAL1      (17<<3) /* reserved for local use */
-#define        LOG_LOCAL2      (18<<3) /* reserved for local use */
-#define        LOG_LOCAL3      (19<<3) /* reserved for local use */
-#define        LOG_LOCAL4      (20<<3) /* reserved for local use */
-#define        LOG_LOCAL5      (21<<3) /* reserved for local use */
-#define        LOG_LOCAL6      (22<<3) /* reserved for local use */
-#define        LOG_LOCAL7      (23<<3) /* reserved for local use */
+/* other codes through 15 reserved for system use */
+#define LOG_LOCAL0      (16<<3) /* reserved for local use */
+#define LOG_LOCAL1      (17<<3) /* reserved for local use */
+#define LOG_LOCAL2      (18<<3) /* reserved for local use */
+#define LOG_LOCAL3      (19<<3) /* reserved for local use */
+#define LOG_LOCAL4      (20<<3) /* reserved for local use */
+#define LOG_LOCAL5      (21<<3) /* reserved for local use */
+#define LOG_LOCAL6      (22<<3) /* reserved for local use */
+#define LOG_LOCAL7      (23<<3) /* reserved for local use */
 
 
-#define        LOG_LAUNCHD             (24<<3) /* launchd - general bootstrap daemon */
+#define LOG_LAUNCHD     (24<<3) /* launchd - general bootstrap daemon */
 
 
-#define        LOG_NFACILITIES 25      /* current number of facilities */
-#define        LOG_FACMASK     0x03f8  /* mask to extract facility part */
-                               /* facility of pri */
-#define        LOG_FAC(p)      (((p) & LOG_FACMASK) >> 3)
+#define LOG_NFACILITIES 25      /* current number of facilities */
+#define LOG_FACMASK     0x03f8  /* mask to extract facility part */
+/* facility of pri */
+#define LOG_FAC(p)      (((p) & LOG_FACMASK) >> 3)
 
 #ifdef SYSLOG_NAMES
 CODE facilitynames[] = {
 
 #ifdef SYSLOG_NAMES
 CODE facilitynames[] = {
-       { "auth",       LOG_AUTH },
-       { "authpriv",   LOG_AUTHPRIV },
-       { "cron",       LOG_CRON },
-       { "daemon",     LOG_DAEMON },
-       { "ftp",        LOG_FTP },
-       { "install",    LOG_INSTALL },
-       { "kern",       LOG_KERN },
-       { "lpr",        LOG_LPR },
-       { "mail",       LOG_MAIL },
-       { "mark",       INTERNAL_MARK },        /* INTERNAL */
-       { "netinfo",    LOG_NETINFO },
-       { "ras",        LOG_RAS },
-       { "remoteauth", LOG_REMOTEAUTH },
-       { "news",       LOG_NEWS },
-       { "security",   LOG_AUTH },             /* DEPRECATED */
-       { "syslog",     LOG_SYSLOG },
-       { "user",       LOG_USER },
-       { "uucp",       LOG_UUCP },
-       { "local0",     LOG_LOCAL0 },
-       { "local1",     LOG_LOCAL1 },
-       { "local2",     LOG_LOCAL2 },
-       { "local3",     LOG_LOCAL3 },
-       { "local4",     LOG_LOCAL4 },
-       { "local5",     LOG_LOCAL5 },
-       { "local6",     LOG_LOCAL6 },
-       { "local7",     LOG_LOCAL7 },
-       { "launchd",    LOG_LAUNCHD },
-       { 0,            -1 }
+       { "auth", LOG_AUTH, },
+       { "authpriv", LOG_AUTHPRIV, },
+       { "cron", LOG_CRON, },
+       { "daemon", LOG_DAEMON, },
+       { "ftp", LOG_FTP, },
+       { "install", LOG_INSTALL     },
+       { "kern", LOG_KERN, },
+       { "lpr", LOG_LPR, },
+       { "mail", LOG_MAIL, },
+       { "mark", INTERNAL_MARK, },             /* INTERNAL */
+       { "netinfo", LOG_NETINFO, },
+       { "ras", LOG_RAS         },
+       { "remoteauth", LOG_REMOTEAUTH  },
+       { "news", LOG_NEWS, },
+       { "security", LOG_AUTH        },        /* DEPRECATED */
+       { "syslog", LOG_SYSLOG, },
+       { "user", LOG_USER, },
+       { "uucp", LOG_UUCP, },
+       { "local0", LOG_LOCAL0, },
+       { "local1", LOG_LOCAL1, },
+       { "local2", LOG_LOCAL2, },
+       { "local3", LOG_LOCAL3, },
+       { "local4", LOG_LOCAL4, },
+       { "local5", LOG_LOCAL5, },
+       { "local6", LOG_LOCAL6, },
+       { "local7", LOG_LOCAL7, },
+       { "launchd", LOG_LAUNCHD     },
+       { NULL, -1, }
 };
 #endif
 
 #ifdef KERNEL
 #ifdef __APPLE_API_PRIVATE
 };
 #endif
 
 #ifdef KERNEL
 #ifdef __APPLE_API_PRIVATE
-#define        LOG_PRINTF      -1      /* pseudo-priority to indicate use of printf */
+#define LOG_PRINTF      -1      /* pseudo-priority to indicate use of printf */
 #endif /* __APPLE_API_PRIVATE */
 #endif
 
 /*
  * arguments to setlogmask.
  */
 #endif /* __APPLE_API_PRIVATE */
 #endif
 
 /*
  * arguments to setlogmask.
  */
-#define        LOG_MASK(pri)   (1 << (pri))            /* mask for one priority */
-#define        LOG_UPTO(pri)   ((1 << ((pri)+1)) - 1)  /* all priorities through pri */
+#define LOG_MASK(pri)   (1 << (pri))            /* mask for one priority */
+#define LOG_UPTO(pri)   ((1 << ((pri)+1)) - 1)  /* all priorities through pri */
 
 /*
  * Option flags for openlog.
 
 /*
  * Option flags for openlog.
@@ -205,26 +207,36 @@ CODE facilitynames[] = {
  * LOG_ODELAY no longer does anything.
  * LOG_NDELAY is the inverse of what it used to be.
  */
  * LOG_ODELAY no longer does anything.
  * LOG_NDELAY is the inverse of what it used to be.
  */
-#define        LOG_PID         0x01    /* log the pid with each message */
-#define        LOG_CONS        0x02    /* log on the console if errors in sending */
-#define        LOG_ODELAY      0x04    /* delay open until first syslog() (default) */
-#define        LOG_NDELAY      0x08    /* don't delay open */
-#define        LOG_NOWAIT      0x10    /* don't wait for console forks: DEPRECATED */
-#define        LOG_PERROR      0x20    /* log to stderr as well */
+#define LOG_PID         0x01    /* log the pid with each message */
+#define LOG_CONS        0x02    /* log on the console if errors in sending */
+#define LOG_ODELAY      0x04    /* delay open until first syslog() (default) */
+#define LOG_NDELAY      0x08    /* don't delay open */
+#define LOG_NOWAIT      0x10    /* don't wait for console forks: DEPRECATED */
+#define LOG_PERROR      0x20    /* log to stderr as well */
 
 #ifndef KERNEL
 
 #ifndef KERNEL
-#ifndef _POSIX_C_SOURCE
-#include <sys/_types.h>                /* for __darwin_va_list */
-#endif /* _POSIX_C_SOURCE */
+
+/*
+ * Don't use va_list in the vsyslog() prototype.   Va_list is typedef'd in two
+ * places (<machine/varargs.h> and <machine/stdarg.h>), so if we include one
+ * of them here we may collide with the utility's includes.  It's unreasonable
+ * for utilities to have to include one of them to include syslog.h, so we get
+ * __va_list from <sys/_types.h> and use it.
+ */
+#include <sys/_types.h>
 
 __BEGIN_DECLS
 
 __BEGIN_DECLS
-void   closelog(void);
-void   openlog(const char *, int, int);
-int    setlogmask(int);
-void   syslog(int, const char *, ...) __DARWIN_LDBL_COMPAT(syslog);
-#ifndef _POSIX_C_SOURCE
-void   vsyslog(int, const char *, __darwin_va_list) __DARWIN_LDBL_COMPAT(vsyslog);
-#endif /* _POSIX_C_SOURCE */
+void    closelog(void);
+void    openlog(const char *, int, int);
+int     setlogmask(int);
+#if defined(__ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__) && __DARWIN_C_LEVEL >= __DARWIN_C_FULL
+void    syslog(int, const char *, ...) __DARWIN_ALIAS_STARTING(__MAC_10_13, __IPHONE_NA, __DARWIN_EXTSN(syslog)) __printflike(2, 3) __not_tail_called;
+#else
+void    syslog(int, const char *, ...) __printflike(2, 3) __not_tail_called;
+#endif
+#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
+void    vsyslog(int, const char *, __darwin_va_list) __printflike(2, 0) __not_tail_called;
+#endif
 __END_DECLS
 
 #else /* !KERNEL */
 __END_DECLS
 
 #else /* !KERNEL */
@@ -278,7 +290,7 @@ __END_DECLS
  * rv_name field.  When %n or %N is used rd_values are searched and the
  * symbolic value is printed if a match is found, if no match is found
  * "???" is printed.
  * rv_name field.  When %n or %N is used rd_values are searched and the
  * symbolic value is printed if a match is found, if no match is found
  * "???" is printed.
- *                             
+ *
  * printf("%C", val);
  * int val;
  *
  * printf("%C", val);
  * int val;
  *
@@ -301,19 +313,23 @@ struct reg_values {
  * rd_mask and rd_shift must be defined, other entries may be null
  */
 struct reg_desc {
  * rd_mask and rd_shift must be defined, other entries may be null
  */
 struct reg_desc {
-       unsigned rd_mask;       /* mask to extract field */
-       int rd_shift;           /* shift for extracted value, - >>, + << */
-       char *rd_name;          /* field name */
-       char *rd_format;        /* format to print field */
-       struct reg_values *rd_values;   /* symbolic names of values */
+       unsigned rd_mask;       /* mask to extract field */
+       int rd_shift;           /* shift for extracted value, - >>, + << */
+       char *rd_name;          /* field name */
+       char *rd_format;        /* format to print field */
+       struct reg_values *rd_values;   /* symbolic names of values */
 };
 
 #endif /* __APPLE_API_OBSOLETE */
 
 };
 
 #endif /* __APPLE_API_OBSOLETE */
 
+#include <stdarg.h>
 __BEGIN_DECLS
 __BEGIN_DECLS
-void   logpri(int);
-void   log(int, const char *, ...);
-void   addlog(const char *, ...);
+void    log(int, const char *, ...);
+#ifdef XNU_KERNEL_PRIVATE
+int     vaddlog(const char *, va_list) __printflike(1, 0);
+void    logtime(time_t);
+#endif /* XNU_KERNEL_PRIVATE */
+
 __END_DECLS
 
 #endif /* !KERNEL */
 __END_DECLS
 
 #endif /* !KERNEL */