2 * Copyright (c) 1983, 1993
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 * must display the following acknowledgement:
15 * This product includes software developed by the University of
16 * California, Berkeley and its contributors.
17 * 4. Neither the name of the University nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * 1999-02-22 Arkadiusz MiĆkiewicz <misiek@pld.ORG.PL>
34 * - added Native Language Support
35 * Sun Mar 21 1999 - Arnaldo Carvalho de Melo <acme@conectiva.com.br>
36 * - fixed strerr(errno) in gettext calls
47 #include <sys/types.h>
48 #include <sys/socket.h>
50 #include <arpa/inet.h>
59 #include "closestream.h"
61 #include "pathnames.h"
71 #ifdef HAVE_LIBSYSTEMD
72 # define SD_JOURNAL_SUPPRESS_LOCATION
73 # include <systemd/sd-daemon.h>
74 # include <systemd/sd-journal.h>
77 #ifdef HAVE_SYS_TIMEX_H
78 # include <sys/timex.h>
84 ALL_TYPES
= TYPE_UDP
| TYPE_TCP
88 AF_UNIX_ERRORS_OFF
= 0,
94 OPT_PRIO_PREFIX
= CHAR_MAX
+ 1,
102 OPT_STRUCTURED_DATA_ID
,
103 OPT_STRUCTURED_DATA_PARAM
,
107 /* rfc5424 structured data */
108 struct structured_data
{
109 char *id
; /* SD-ID */
110 char **params
; /* array with SD-PARAMs */
112 struct list_head sds
;
118 pid_t pid
; /* zero when unwanted */
119 char *hdr
; /* the syslog header (based on protocol) */
122 char *unix_socket
; /* -u <path> or default to _PATH_DEVLOG */
126 size_t max_message_size
;
127 struct list_head user_sds
; /* user defined rfc5424 structured data */
128 struct list_head reserved_sds
; /* standard rfc5424 structured data */
130 void (*syslogfp
)(struct logger_ctl
*ctl
);
133 unix_socket_errors
:1, /* whether to report or not errors */
134 noact
:1, /* do not write to sockets */
135 prio_prefix
:1, /* read priority from input */
136 stderr_printout
:1, /* output message to stderr */
137 rfc5424_time
:1, /* include time stamp */
138 rfc5424_tq
:1, /* include time quality markup */
139 rfc5424_host
:1, /* include hostname */
140 skip_empty_lines
:1, /* do not send empty lines when processing files */
141 octet_count
:1; /* use RFC6587 octet counting */
144 #define is_connected(_ctl) ((_ctl)->fd >= 0)
145 static void logger_reopen(struct logger_ctl
*ctl
);
148 * For tests we want to be able to control datetime outputs
151 static inline int logger_gettimeofday(struct timeval
*tv
, struct timezone
*tz
)
153 char *str
= getenv("LOGGER_TEST_TIMEOFDAY");
156 if (str
&& sscanf(str
, "%ju.%ju", &sec
, &usec
) == 2) {
159 return tv
->tv_sec
>= 0 && tv
->tv_usec
>= 0 ? 0 : -EINVAL
;
162 return gettimeofday(tv
, tz
);
165 static inline char *logger_xgethostname(void)
167 char *str
= getenv("LOGGER_TEST_HOSTNAME");
168 return str
? xstrdup(str
) : xgethostname();
171 static inline pid_t
logger_getpid(void)
173 char *str
= getenv("LOGGER_TEST_GETPID");
176 if (str
&& sscanf(str
, "%u", &pid
) == 1)
182 #undef HAVE_NTP_GETTIME /* force to default non-NTP */
184 #else /* !TEST_LOGGER */
185 # define logger_gettimeofday(x, y) gettimeofday(x, y)
186 # define logger_xgethostname xgethostname
187 # define logger_getpid getpid
191 static int decode(const char *name
, const CODE
*codetab
)
193 register const CODE
*c
;
195 if (name
== NULL
|| *name
== '\0')
197 if (isdigit(*name
)) {
202 num
= strtol(name
, &end
, 10);
203 if (errno
|| name
== end
|| (end
&& *end
))
205 for (c
= codetab
; c
->c_name
; c
++)
210 for (c
= codetab
; c
->c_name
; c
++)
211 if (!strcasecmp(name
, c
->c_name
))
217 static int pencode(char *s
)
224 separator
= strchr(s
, '.');
227 facility
= decode(s
, facilitynames
);
229 errx(EXIT_FAILURE
, _("unknown facility name: %s"), s
);
233 level
= decode(s
, prioritynames
);
235 errx(EXIT_FAILURE
, _("unknown priority name: %s"), s
);
236 if (facility
== LOG_KERN
)
237 facility
= LOG_USER
; /* kern is forbidden */
238 return ((level
& LOG_PRIMASK
) | (facility
& LOG_FACMASK
));
241 static int unix_socket(struct logger_ctl
*ctl
, const char *path
, int *socket_type
)
243 int fd
= -1, i
, type
= -1;
244 static struct sockaddr_un s_addr
; /* AF_UNIX address of local logger */
246 if (strlen(path
) >= sizeof(s_addr
.sun_path
))
247 errx(EXIT_FAILURE
, _("openlog %s: pathname too long"), path
);
249 s_addr
.sun_family
= AF_UNIX
;
250 strcpy(s_addr
.sun_path
, path
);
252 for (i
= 2; i
; i
--) {
255 if (i
== 2 && *socket_type
& TYPE_UDP
) {
259 if (i
== 1 && *socket_type
& TYPE_TCP
) {
263 if (st
== -1 || (fd
= socket(AF_UNIX
, st
, 0)) == -1)
265 if (connect(fd
, (struct sockaddr
*)&s_addr
, sizeof(s_addr
)) == -1) {
273 if (ctl
->unix_socket_errors
)
274 err(EXIT_FAILURE
, _("socket %s"), path
);
276 /* write_output() will try to reconnect */
280 /* replace ALL_TYPES with the real TYPE_* */
281 if (type
> 0 && type
!= *socket_type
)
286 static int inet_socket(const char *servername
, const char *port
, int *socket_type
)
288 int fd
, errcode
, i
, type
= -1;
289 struct addrinfo hints
, *res
;
290 const char *p
= port
;
292 for (i
= 2; i
; i
--) {
293 memset(&hints
, 0, sizeof(hints
));
294 if (i
== 2 && *socket_type
& TYPE_UDP
) {
295 hints
.ai_socktype
= SOCK_DGRAM
;
300 if (i
== 1 && *socket_type
& TYPE_TCP
) {
301 hints
.ai_socktype
= SOCK_STREAM
;
306 if (hints
.ai_socktype
== 0)
308 hints
.ai_family
= AF_UNSPEC
;
309 errcode
= getaddrinfo(servername
, p
, &hints
, &res
);
311 errx(EXIT_FAILURE
, _("failed to resolve name %s port %s: %s"),
312 servername
, p
, gai_strerror(errcode
));
313 if ((fd
= socket(res
->ai_family
, res
->ai_socktype
, res
->ai_protocol
)) == -1) {
317 if (connect(fd
, res
->ai_addr
, res
->ai_addrlen
) == -1) {
328 errx(EXIT_FAILURE
, _("failed to connect to %s port %s"), servername
, p
);
330 /* replace ALL_TYPES with the real TYPE_* */
331 if (type
> 0 && type
!= *socket_type
)
336 #ifdef HAVE_LIBSYSTEMD
337 static int journald_entry(struct logger_ctl
*ctl
, FILE *fp
)
342 int n
, lines
= 0, vectors
= 8, ret
= 0, msgline
= -1;
345 iovec
= xmalloc(vectors
* sizeof(struct iovec
));
348 sz
= getline(&buf
, &dummy
, fp
);
350 (sz
= rtrim_whitespace((unsigned char *) buf
)) == 0) {
355 if (strncmp(buf
, "MESSAGE=", 8) == 0) {
357 msgline
= lines
; /* remember the first message */
359 char *p
= xrealloc(iovec
[msgline
].iov_base
,
360 iovec
[msgline
].iov_len
+ sz
- 8 + 2);
362 iovec
[msgline
].iov_base
= p
;
363 p
+= iovec
[msgline
].iov_len
;
365 memcpy(p
, buf
+ 8, sz
- 8);
368 iovec
[msgline
].iov_len
+= sz
- 8 + 1;
373 if (lines
== vectors
) {
375 if (IOV_MAX
< vectors
)
376 errx(EXIT_FAILURE
, _("maximum input lines (%d) exceeded"), IOV_MAX
);
377 iovec
= xrealloc(iovec
, vectors
* sizeof(struct iovec
));
379 iovec
[lines
].iov_base
= buf
;
380 iovec
[lines
].iov_len
= sz
;
385 ret
= sd_journal_sendv(iovec
, lines
);
386 if (ctl
->stderr_printout
) {
387 for (n
= 0; n
< lines
; n
++)
388 fprintf(stderr
, "%s\n", (char *) iovec
[n
].iov_base
);
390 for (n
= 0; n
< lines
; n
++)
391 free(iovec
[n
].iov_base
);
397 /* this creates a timestamp based on current time according to the
398 * fine rules of RFC3164, most importantly it ensures in a portable
399 * way that the month day is correctly written (with a SP instead
400 * of a leading 0). The function uses a static buffer which is
401 * overwritten on the next call (just like ctime() does).
403 static char const *rfc3164_current_time(void)
405 static char time
[32];
408 static char const * const monthnames
[] = {
409 "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug",
410 "Sep", "Oct", "Nov", "Dec"
413 logger_gettimeofday(&tv
, NULL
);
414 localtime_r(&tv
.tv_sec
, &tm
);
415 snprintf(time
, sizeof(time
),"%s %2d %2.2d:%2.2d:%2.2d",
416 monthnames
[tm
.tm_mon
], tm
.tm_mday
,
417 tm
.tm_hour
, tm
.tm_min
, tm
.tm_sec
);
421 #define next_iovec(ary, idx) __extension__ ({ \
422 assert(ARRAY_SIZE(ary) > (size_t)idx); \
427 #define iovec_add_string(ary, idx, str, len) \
429 struct iovec *v = next_iovec(ary, idx); \
430 v->iov_base = (void *) str; \
431 v->iov_len = len ? len : strlen(str); \
434 #define iovec_memcmp(ary, idx, str, len) \
435 memcmp((ary)[(idx) - 1].iov_base, str, len)
437 /* writes generated buffer to desired destination. For TCP syslog,
438 * we use RFC6587 octet-stuffing (unless octet-counting is selected).
439 * This is not great, but doing full blown RFC5425 (TLS) looks like
440 * it is too much for the logger utility. If octet-counting is
441 * selected, we use that.
443 static void write_output(struct logger_ctl
*ctl
, const char *const msg
)
449 /* initial connect failed? */
450 if (!ctl
->noact
&& !is_connected(ctl
))
454 if (ctl
->octet_count
) {
455 size_t len
= xasprintf(&octet
, "%zu ", strlen(ctl
->hdr
) + strlen(msg
));
456 iovec_add_string(iov
, iovlen
, octet
, len
);
460 iovec_add_string(iov
, iovlen
, ctl
->hdr
, 0);
463 iovec_add_string(iov
, iovlen
, msg
, 0);
465 if (!ctl
->noact
&& is_connected(ctl
)) {
466 struct msghdr message
= { 0 };
467 #ifdef SCM_CREDENTIALS
468 struct cmsghdr
*cmhp
;
472 char control
[CMSG_SPACE(sizeof(struct ucred
))];
476 /* 4) add extra \n to make sure message is terminated */
477 if ((ctl
->socket_type
== TYPE_TCP
) && !ctl
->octet_count
)
478 iovec_add_string(iov
, iovlen
, "\n", 1);
480 message
.msg_iov
= iov
;
481 message
.msg_iovlen
= iovlen
;
483 #ifdef SCM_CREDENTIALS
484 /* syslog/journald may follow local socket credentials rather
485 * than in the message PID. If we use --id as root than we can
486 * force kernel to accept another valid PID than the real logger(1)
489 if (ctl
->pid
&& !ctl
->server
&& ctl
->pid
!= getpid()
490 && geteuid() == 0 && kill(ctl
->pid
, 0) == 0) {
492 message
.msg_control
= cbuf
.control
;
493 message
.msg_controllen
= CMSG_SPACE(sizeof(struct ucred
));
495 cmhp
= CMSG_FIRSTHDR(&message
);
496 cmhp
->cmsg_len
= CMSG_LEN(sizeof(struct ucred
));
497 cmhp
->cmsg_level
= SOL_SOCKET
;
498 cmhp
->cmsg_type
= SCM_CREDENTIALS
;
499 cred
= (struct ucred
*) CMSG_DATA(cmhp
);
501 cred
->pid
= ctl
->pid
;
504 /* Note that logger(1) maybe executed for long time (as pipe
505 * reader) and connection endpoint (syslogd) may be restarted.
507 * The libc syslog() function reconnects on failed send().
508 * Let's do the same to be robust. [kzak -- Oct 2017]
510 * MSG_NOSIGNAL is POSIX.1-2008 compatible, but it for example
511 * not supported by apple-darwin15.6.0.
514 # define MSG_NOSIGNAL 0
516 if (sendmsg(ctl
->fd
, &message
, MSG_NOSIGNAL
) < 0) {
518 if (sendmsg(ctl
->fd
, &message
, MSG_NOSIGNAL
) < 0)
519 warn(_("send message failed"));
523 if (ctl
->stderr_printout
) {
524 /* make sure it's terminated for stderr */
525 if (iovec_memcmp(iov
, iovlen
, "\n", 1) != 0)
526 iovec_add_string(iov
, iovlen
, "\n", 1);
528 ignore_result( writev(STDERR_FILENO
, iov
, iovlen
) );
535 static void syslog_rfc3164_header(struct logger_ctl
*const ctl
)
537 char pid
[30], *hostname
;
541 snprintf(pid
, sizeof(pid
), "[%d]", ctl
->pid
);
543 if ((hostname
= logger_xgethostname())) {
544 char *dot
= strchr(hostname
, '.');
548 hostname
= xstrdup(NILVALUE
);
550 xasprintf(&ctl
->hdr
, "<%d>%.15s %s %.200s%s: ",
551 ctl
->pri
, rfc3164_current_time(), hostname
, ctl
->tag
, pid
);
556 static inline struct list_head
*get_user_structured_data(struct logger_ctl
*ctl
)
558 return &ctl
->user_sds
;
561 static inline struct list_head
*get_reserved_structured_data(struct logger_ctl
*ctl
)
563 return &ctl
->reserved_sds
;
566 static int has_structured_data_id(struct list_head
*ls
, const char *id
)
570 if (!ls
|| list_empty(ls
))
573 list_for_each(p
, ls
) {
574 struct structured_data
*sd
= list_entry(p
, struct structured_data
, sds
);
575 if (sd
->id
&& strcmp(sd
->id
, id
) == 0)
582 static void add_structured_data_id(struct list_head
*ls
, const char *id
)
584 struct structured_data
*sd
;
588 if (has_structured_data_id(ls
, id
))
589 errx(EXIT_FAILURE
, _("structured data ID '%s' is not unique"), id
);
591 sd
= xcalloc(1, sizeof(*sd
));
592 INIT_LIST_HEAD(&sd
->sds
);
593 sd
->id
= xstrdup(id
);
595 list_add_tail(&sd
->sds
, ls
);
598 static void add_structured_data_param(struct list_head
*ls
, const char *param
)
600 struct structured_data
*sd
;
603 errx(EXIT_FAILURE
, _("--sd-id was not specified for --sd-param %s"), param
);
607 sd
= list_last_entry(ls
, struct structured_data
, sds
);
609 if (strv_extend(&sd
->params
, param
))
613 static void __attribute__ ((__format__ (__printf__
, 2, 3)))
614 add_structured_data_paramf(struct list_head
*ls
, const char *fmt
, ...)
616 struct structured_data
*sd
;
620 assert(!list_empty(ls
));
623 sd
= list_last_entry(ls
, struct structured_data
, sds
);
625 x
= strv_extendv(&sd
->params
, fmt
, ap
);
632 static char *strdup_structured_data(struct structured_data
*sd
)
636 if (strv_isempty(sd
->params
))
639 xasprintf(&res
, "[%s %s]", sd
->id
,
640 (tmp
= strv_join(sd
->params
, " ")));
645 static char *strdup_structured_data_list(struct list_head
*ls
)
650 list_for_each(p
, ls
) {
651 struct structured_data
*sd
= list_entry(p
, struct structured_data
, sds
);
652 char *one
= strdup_structured_data(sd
);
657 res
= strappend(tmp
, one
);
665 static char *get_structured_data_string(struct logger_ctl
*ctl
)
667 char *sys
= NULL
, *usr
= NULL
, *res
;
669 if (!list_empty(&ctl
->reserved_sds
))
670 sys
= strdup_structured_data_list(&ctl
->reserved_sds
);
671 if (!list_empty(&ctl
->user_sds
))
672 usr
= strdup_structured_data_list(&ctl
->user_sds
);
675 res
= strappend(sys
, usr
);
679 res
= sys
? sys
: usr
;
684 static int valid_structured_data_param(const char *str
)
686 char *eq
= strchr(str
, '='),
687 *qm1
= strchr(str
, '"'),
688 *qm2
= qm1
? strchr(qm1
+ 1, '"') : NULL
;
690 if (!eq
|| !qm1
|| !qm2
) /* something is missing */
694 return eq
> str
&& eq
< qm1
&& eq
+ 1 == qm1
&& qm1
< qm2
&& *(qm2
+ 1) == '\0';
698 * name@<private enterprise number>, e.g., "ourSDID@32473"
700 static int valid_structured_data_id(const char *str
)
702 char *at
= strchr(str
, '@');
705 /* standardized IDs without @<digits> */
706 if (!at
&& (strcmp(str
, "timeQuality") == 0 ||
707 strcmp(str
, "origin") == 0 ||
708 strcmp(str
, "meta") == 0))
711 if (!at
|| at
== str
|| !*(at
+ 1))
714 /* <digits> or <digits>.<digits>[...] */
715 for (p
= at
+ 1; p
&& *p
; p
++) {
718 if (isdigit_strend(p
, &end
))
719 break; /* only digits in the string */
721 if (end
== NULL
|| end
== p
||
722 *end
!= '.' || *(end
+ 1) == '\0')
727 /* check for forbidden chars in the <name> */
728 for (p
= str
; p
< at
; p
++) {
729 if (*p
== '[' || *p
== '=' || *p
== '"' || *p
== '@')
731 if (isblank((unsigned char) *p
) || iscntrl((unsigned char) *p
))
738 /* Some field mappings may be controversial, thus I give the reason
739 * why this specific mapping was used:
741 * Some may argue that "logger" is a better fit, but we think
742 * this is better inline of what other implementations do. In
743 * rsyslog, for example, the TAG value is populated from APP-NAME.
745 * This is a relatively straightforward interpretation from
746 * RFC5424, sect. 6.2.6.
747 * MSGID <-- msgid (from --msgid)
748 * One may argue that the string "logger" would be better suited
749 * here so that a receiver can identify the sender process.
750 * However, this does not sound like a good match to RFC5424,
752 * Note that appendix A.1 of RFC5424 does not provide clear guidance
753 * of how these fields should be used. This is the case because the
754 * IETF working group couldn't arrive at a clear agreement when we
755 * specified RFC5424. The rest of the field mappings should be
756 * pretty clear from RFC5424. -- Rainer Gerhards, 2015-03-10
758 static void syslog_rfc5424_header(struct logger_ctl
*const ctl
)
762 char const *app_name
= ctl
->tag
;
764 char *const msgid
= xstrdup(ctl
->msgid
? ctl
->msgid
: NILVALUE
);
765 char *structured
= NULL
;
766 struct list_head
*sd
;
768 if (ctl
->rfc5424_time
) {
772 logger_gettimeofday(&tv
, NULL
);
773 if (localtime_r(&tv
.tv_sec
, &tm
) != NULL
) {
775 const size_t i
= strftime(fmt
, sizeof(fmt
),
776 "%Y-%m-%dT%H:%M:%S.%%06u%z ", &tm
);
777 /* patch TZ info to comply with RFC3339 (we left SP at end) */
778 fmt
[i
- 1] = fmt
[i
- 2];
779 fmt
[i
- 2] = fmt
[i
- 3];
781 xasprintf(&time
, fmt
, tv
.tv_usec
);
783 err(EXIT_FAILURE
, _("localtime() failed"));
785 time
= xstrdup(NILVALUE
);
787 if (ctl
->rfc5424_host
) {
788 if (!(hostname
= logger_xgethostname()))
789 hostname
= xstrdup(NILVALUE
);
790 /* Arbitrary looking 'if (var < strlen()) checks originate from
791 * RFC 5424 - 6 Syslog Message Format definition. */
792 if (255 < strlen(hostname
))
793 errx(EXIT_FAILURE
, _("hostname '%s' is too long"),
796 hostname
= xstrdup(NILVALUE
);
798 if (48 < strlen(ctl
->tag
))
799 errx(EXIT_FAILURE
, _("tag '%s' is too long"), ctl
->tag
);
802 xasprintf(&procid
, "%d", ctl
->pid
);
804 procid
= xstrdup(NILVALUE
);
806 sd
= get_reserved_structured_data(ctl
);
808 /* time quality structured data (maybe overwritten by --sd-id timeQuality) */
809 if (ctl
->rfc5424_tq
&& !has_structured_data_id(sd
, "timeQuality")) {
811 add_structured_data_id(sd
, "timeQuality");
812 add_structured_data_param(sd
, "tzKnown=\"1\"");
814 #ifdef HAVE_NTP_GETTIME
815 struct ntptimeval ntptv
;
817 if (ntp_gettime(&ntptv
) == TIME_OK
) {
818 add_structured_data_param(sd
, "isSynced=\"1\"");
819 add_structured_data_paramf(sd
, "syncAccuracy=\"%ld\"", ntptv
.maxerror
);
822 add_structured_data_paramf(sd
, "isSynced=\"0\"");
825 /* convert all structured data to string */
826 structured
= get_structured_data_string(ctl
);
828 structured
= xstrdup(NILVALUE
);
830 xasprintf(&ctl
->hdr
, "<%d>1 %s %s %s %s %s %s ",
841 /* app_name points to ctl->tag, do NOT free! */
847 static void parse_rfc5424_flags(struct logger_ctl
*ctl
, char *s
)
852 while ((tok
= strtok(in
, ","))) {
854 if (!strcmp(tok
, "notime")) {
855 ctl
->rfc5424_time
= 0;
857 } else if (!strcmp(tok
, "notq"))
859 else if (!strcmp(tok
, "nohost"))
860 ctl
->rfc5424_host
= 0;
862 warnx(_("ignoring unknown option argument: %s"), tok
);
866 static int parse_unix_socket_errors_flags(char *s
)
868 if (!strcmp(s
, "off"))
869 return AF_UNIX_ERRORS_OFF
;
870 if (!strcmp(s
, "on"))
871 return AF_UNIX_ERRORS_ON
;
872 if (!strcmp(s
, "auto"))
873 return AF_UNIX_ERRORS_AUTO
;
874 warnx(_("invalid argument: %s: using automatic errors"), s
);
875 return AF_UNIX_ERRORS_AUTO
;
878 static void syslog_local_header(struct logger_ctl
*const ctl
)
883 snprintf(pid
, sizeof(pid
), "[%d]", ctl
->pid
);
887 xasprintf(&ctl
->hdr
, "<%d>%s %s%s: ", ctl
->pri
, rfc3164_current_time(),
891 static void generate_syslog_header(struct logger_ctl
*const ctl
)
898 /* just open, nothing else */
899 static void __logger_open(struct logger_ctl
*ctl
)
902 ctl
->fd
= inet_socket(ctl
->server
, ctl
->port
, &ctl
->socket_type
);
904 if (!ctl
->unix_socket
)
905 ctl
->unix_socket
= _PATH_DEVLOG
;
907 ctl
->fd
= unix_socket(ctl
, ctl
->unix_socket
, &ctl
->socket_type
);
911 /* open and initialize relevant @ctl tuff */
912 static void logger_open(struct logger_ctl
*ctl
)
917 ctl
->syslogfp
= ctl
->server
? syslog_rfc5424_header
:
920 ctl
->tag
= xgetlogin();
922 ctl
->tag
= "<someone>";
924 generate_syslog_header(ctl
);
927 /* re-open; usually after failed connection */
928 static void logger_reopen(struct logger_ctl
*ctl
)
937 static void logger_command_line(struct logger_ctl
*ctl
, char **argv
)
939 /* note: we never re-generate the syslog header here, even if we
940 * generate multiple messages. If so, we think it is the right thing
941 * to do to report them with the same timestamp, as the user actually
942 * intended to send a single message.
944 char *const buf
= xmalloc(ctl
->max_message_size
+ 1);
946 const char *endp
= buf
+ ctl
->max_message_size
- 1;
951 if (endp
< p
+ len
&& p
!= buf
) {
952 write_output(ctl
, buf
);
955 if (ctl
->max_message_size
< len
) {
956 (*argv
)[ctl
->max_message_size
] = '\0'; /* truncate */
957 write_output(ctl
, *argv
++);
962 memmove(p
, *argv
++, len
);
966 write_output(ctl
, buf
);
970 static void logger_stdin(struct logger_ctl
*ctl
)
972 /* note: we re-generate the syslog header for each log message to
973 * update header timestamps and to reflect possible priority changes.
974 * The initial header is generated by logger_open().
977 int default_priority
= ctl
->pri
;
978 int last_pri
= default_priority
;
979 size_t max_usrmsg_size
= ctl
->max_message_size
- strlen(ctl
->hdr
);
980 char *const buf
= xmalloc(max_usrmsg_size
+ 2 + 2);
988 if (ctl
->prio_prefix
&& c
== '<') {
991 while (isdigit(c
= getchar()) && pri
<= 191) {
993 pri
= pri
* 10 + c
- '0';
995 if (c
!= EOF
&& c
!= '\n')
997 if (c
== '>' && 0 <= pri
&& pri
<= 191) {
998 /* valid RFC PRI values */
1000 if (pri
< 8) /* kern facility is forbidden */
1004 ctl
->pri
= default_priority
;
1006 if (ctl
->pri
!= last_pri
) {
1009 ctl
->max_message_size
- strlen(ctl
->hdr
);
1010 last_pri
= ctl
->pri
;
1012 if (c
!= EOF
&& c
!= '\n')
1016 while (c
!= EOF
&& c
!= '\n' && i
< max_usrmsg_size
) {
1022 if (i
> 0 || !ctl
->skip_empty_lines
) {
1024 generate_syslog_header(ctl
);
1025 write_output(ctl
, buf
);
1029 if (c
== '\n') /* discard line terminator */
1036 static void logger_close(const struct logger_ctl
*ctl
)
1038 if (ctl
->fd
!= -1 && close(ctl
->fd
) != 0)
1039 err(EXIT_FAILURE
, _("close failed"));
1043 static void __attribute__((__noreturn__
)) usage(void)
1046 fputs(USAGE_HEADER
, out
);
1047 fprintf(out
, _(" %s [options] [<message>]\n"), program_invocation_short_name
);
1049 fputs(USAGE_SEPARATOR
, out
);
1050 fputs(_("Enter messages into the system log.\n"), out
);
1052 fputs(USAGE_OPTIONS
, out
);
1053 fputs(_(" -i log the logger command's PID\n"), out
);
1054 fputs(_(" --id[=<id>] log the given <id>, or otherwise the PID\n"), out
);
1055 fputs(_(" -f, --file <file> log the contents of this file\n"), out
);
1056 fputs(_(" -e, --skip-empty do not log empty lines when processing files\n"), out
);
1057 fputs(_(" --no-act do everything except the write the log\n"), out
);
1058 fputs(_(" -p, --priority <prio> mark given message with this priority\n"), out
);
1059 fputs(_(" --octet-count use rfc6587 octet counting\n"), out
);
1060 fputs(_(" --prio-prefix look for a prefix on every line read from stdin\n"), out
);
1061 fputs(_(" -s, --stderr output message to standard error as well\n"), out
);
1062 fputs(_(" -S, --size <size> maximum size for a single message\n"), out
);
1063 fputs(_(" -t, --tag <tag> mark every line with this tag\n"), out
);
1064 fputs(_(" -n, --server <name> write to this remote syslog server\n"), out
);
1065 fputs(_(" -P, --port <port> use this port for UDP or TCP connection\n"), out
);
1066 fputs(_(" -T, --tcp use TCP only\n"), out
);
1067 fputs(_(" -d, --udp use UDP only\n"), out
);
1068 fputs(_(" --rfc3164 use the obsolete BSD syslog protocol\n"), out
);
1069 fputs(_(" --rfc5424[=<snip>] use the syslog protocol (the default for remote);\n"
1070 " <snip> can be notime, or notq, and/or nohost\n"), out
);
1071 fputs(_(" --sd-id <id> rfc5424 structured data ID\n"), out
);
1072 fputs(_(" --sd-param <data> rfc5424 structured data name=value\n"), out
);
1073 fputs(_(" --msgid <msgid> set rfc5424 message id field\n"), out
);
1074 fputs(_(" -u, --socket <socket> write to this Unix socket\n"), out
);
1075 fputs(_(" --socket-errors[=<on|off|auto>]\n"
1076 " print connection errors when using Unix sockets\n"), out
);
1077 #ifdef HAVE_LIBSYSTEMD
1078 fputs(_(" --journald[=<file>] write journald entry\n"), out
);
1081 fputs(USAGE_SEPARATOR
, out
);
1082 printf(USAGE_HELP_OPTIONS(26));
1083 printf(USAGE_MAN_TAIL("logger(1)"));
1089 * logger -- read and log utility
1091 * Reads from an input and arranges to write the result on the system
1094 int main(int argc
, char **argv
)
1096 struct logger_ctl ctl
= {
1099 .pri
= LOG_USER
| LOG_NOTICE
,
1102 .unix_socket
= NULL
,
1103 .unix_socket_errors
= 0,
1108 .socket_type
= ALL_TYPES
,
1109 .max_message_size
= 1024,
1113 .skip_empty_lines
= 0
1116 int stdout_reopened
= 0;
1117 int unix_socket_errors_mode
= AF_UNIX_ERRORS_AUTO
;
1118 #ifdef HAVE_LIBSYSTEMD
1121 static const struct option longopts
[] = {
1122 { "id", optional_argument
, 0, OPT_ID
},
1123 { "stderr", no_argument
, 0, 's' },
1124 { "file", required_argument
, 0, 'f' },
1125 { "no-act", no_argument
, 0, OPT_NOACT
, },
1126 { "priority", required_argument
, 0, 'p' },
1127 { "tag", required_argument
, 0, 't' },
1128 { "socket", required_argument
, 0, 'u' },
1129 { "socket-errors", required_argument
, 0, OPT_SOCKET_ERRORS
},
1130 { "udp", no_argument
, 0, 'd' },
1131 { "tcp", no_argument
, 0, 'T' },
1132 { "server", required_argument
, 0, 'n' },
1133 { "port", required_argument
, 0, 'P' },
1134 { "version", no_argument
, 0, 'V' },
1135 { "help", no_argument
, 0, 'h' },
1136 { "octet-count", no_argument
, 0, OPT_OCTET_COUNT
},
1137 { "prio-prefix", no_argument
, 0, OPT_PRIO_PREFIX
},
1138 { "rfc3164", no_argument
, 0, OPT_RFC3164
},
1139 { "rfc5424", optional_argument
, 0, OPT_RFC5424
},
1140 { "size", required_argument
, 0, 'S' },
1141 { "msgid", required_argument
, 0, OPT_MSGID
},
1142 { "skip-empty", no_argument
, 0, 'e' },
1143 { "sd-id", required_argument
, 0, OPT_STRUCTURED_DATA_ID
},
1144 { "sd-param", required_argument
, 0, OPT_STRUCTURED_DATA_PARAM
},
1145 #ifdef HAVE_LIBSYSTEMD
1146 { "journald", optional_argument
, 0, OPT_JOURNALD
},
1151 setlocale(LC_ALL
, "");
1152 bindtextdomain(PACKAGE
, LOCALEDIR
);
1153 textdomain(PACKAGE
);
1154 close_stdout_atexit();
1156 INIT_LIST_HEAD(&ctl
.user_sds
);
1157 INIT_LIST_HEAD(&ctl
.reserved_sds
);
1159 while ((ch
= getopt_long(argc
, argv
, "ef:ip:S:st:u:dTn:P:Vh",
1160 longopts
, NULL
)) != -1) {
1162 case 'f': /* file to log */
1163 if (freopen(optarg
, "r", stdin
) == NULL
)
1164 err(EXIT_FAILURE
, _("file %s"), optarg
);
1165 stdout_reopened
= 1;
1168 ctl
.skip_empty_lines
= 1;
1170 case 'i': /* log process id also */
1171 ctl
.pid
= logger_getpid();
1175 const char *p
= optarg
;
1179 ctl
.pid
= strtoul_or_err(optarg
, _("failed to parse id"));
1181 ctl
.pid
= logger_getpid();
1183 case 'p': /* priority */
1184 ctl
.pri
= pencode(optarg
);
1186 case 's': /* log to standard error */
1187 ctl
.stderr_printout
= 1;
1192 case 'u': /* unix socket */
1193 ctl
.unix_socket
= optarg
;
1195 case 'S': /* max message size */
1196 ctl
.max_message_size
= strtosize_or_err(optarg
,
1197 _("failed to parse message size"));
1200 ctl
.socket_type
= TYPE_UDP
;
1203 ctl
.socket_type
= TYPE_TCP
;
1206 ctl
.server
= optarg
;
1211 case OPT_OCTET_COUNT
:
1212 ctl
.octet_count
= 1;
1214 case OPT_PRIO_PREFIX
:
1215 ctl
.prio_prefix
= 1;
1218 ctl
.syslogfp
= syslog_rfc3164_header
;
1221 ctl
.syslogfp
= syslog_rfc5424_header
;
1223 parse_rfc5424_flags(&ctl
, optarg
);
1226 if (strchr(optarg
, ' '))
1227 errx(EXIT_FAILURE
, _("--msgid cannot contain space"));
1230 #ifdef HAVE_LIBSYSTEMD
1233 jfd
= fopen(optarg
, "r");
1235 err(EXIT_FAILURE
, _("cannot open %s"),
1241 case OPT_SOCKET_ERRORS
:
1242 unix_socket_errors_mode
= parse_unix_socket_errors_flags(optarg
);
1247 case OPT_STRUCTURED_DATA_ID
:
1248 if (!valid_structured_data_id(optarg
))
1249 errx(EXIT_FAILURE
, _("invalid structured data ID: '%s'"), optarg
);
1250 add_structured_data_id(get_user_structured_data(&ctl
), optarg
);
1252 case OPT_STRUCTURED_DATA_PARAM
:
1253 if (!valid_structured_data_param(optarg
))
1254 errx(EXIT_FAILURE
, _("invalid structured data parameter: '%s'"), optarg
);
1255 add_structured_data_param(get_user_structured_data(&ctl
), optarg
);
1259 print_version(EXIT_SUCCESS
);
1263 errtryhelp(EXIT_FAILURE
);
1268 if (stdout_reopened
&& argc
)
1269 warnx(_("--file <file> and <message> are mutually exclusive, message is ignored"));
1270 #ifdef HAVE_LIBSYSTEMD
1272 int ret
= journald_entry(&ctl
, jfd
);
1276 errx(EXIT_FAILURE
, _("journald entry could not be written"));
1277 return EXIT_SUCCESS
;
1281 /* user overwrites built-in SD-ELEMENT */
1282 if (has_structured_data_id(get_user_structured_data(&ctl
), "timeQuality"))
1285 switch (unix_socket_errors_mode
) {
1286 case AF_UNIX_ERRORS_OFF
:
1287 ctl
.unix_socket_errors
= 0;
1289 case AF_UNIX_ERRORS_ON
:
1290 ctl
.unix_socket_errors
= 1;
1292 case AF_UNIX_ERRORS_AUTO
:
1293 ctl
.unix_socket_errors
= ctl
.noact
|| ctl
.stderr_printout
;
1294 #ifdef HAVE_LIBSYSTEMD
1295 ctl
.unix_socket_errors
|= !!sd_booted();
1303 logger_command_line(&ctl
, argv
);
1305 /* Note. --file <arg> reopens stdin making the below
1306 * function to be used for file inputs. */
1309 return EXIT_SUCCESS
;