1 /* $NetBSD: postkick.c,v 1.3 2020/03/18 19:05:18 christos Exp $ */ 2 3 /*++ 4 /* NAME 5 /* postkick 1 6 /* SUMMARY 7 /* kick a Postfix service 8 /* SYNOPSIS 9 /* .fi 10 /* \fBpostkick\fR [\fB-c \fIconfig_dir\fR] [\fB-v\fR] 11 /* \fIclass service request\fR 12 /* DESCRIPTION 13 /* The \fBpostkick\fR(1) command sends \fIrequest\fR to the 14 /* specified \fIservice\fR over a local transport channel. 15 /* This command makes Postfix private IPC accessible 16 /* for use in, for example, shell scripts. 17 /* 18 /* Options: 19 /* .IP "\fB-c\fR \fIconfig_dir\fR" 20 /* Read the \fBmain.cf\fR configuration file in the named directory 21 /* instead of the default configuration directory. 22 /* .IP \fB-v\fR 23 /* Enable verbose logging for debugging purposes. Multiple \fB-v\fR 24 /* options make the software increasingly verbose. 25 /* .PP 26 /* Arguments: 27 /* .IP \fIclass\fR 28 /* Name of a class of local transport channel endpoints, 29 /* either \fBpublic\fR (accessible by any local user) or 30 /* \fBprivate\fR (administrative access only). 31 /* .IP \fIservice\fR 32 /* The name of a local transport endpoint within the named class. 33 /* .IP \fIrequest\fR 34 /* A string. The list of valid requests is service-specific. 35 /* DIAGNOSTICS 36 /* Problems and transactions are logged to the standard error 37 /* stream. 38 /* ENVIRONMENT 39 /* .ad 40 /* .fi 41 /* .IP \fBMAIL_CONFIG\fR 42 /* Directory with Postfix configuration files. 43 /* .IP \fBMAIL_VERBOSE\fR 44 /* Enable verbose logging for debugging purposes. 45 /* CONFIGURATION PARAMETERS 46 /* .ad 47 /* .fi 48 /* The following \fBmain.cf\fR parameters are especially relevant to 49 /* this program. 50 /* The text below provides only a parameter summary. See 51 /* \fBpostconf\fR(5) for more details including examples. 52 /* .IP "\fBconfig_directory (see 'postconf -d' output)\fR" 53 /* The default location of the Postfix main.cf and master.cf 54 /* configuration files. 55 /* .IP "\fBapplication_event_drain_time (100s)\fR" 56 /* How long the \fBpostkick\fR(1) command waits for a request to enter the 57 /* Postfix daemon process input buffer before giving up. 58 /* .IP "\fBimport_environment (see 'postconf -d' output)\fR" 59 /* The list of environment parameters that a privileged Postfix 60 /* process will import from a non-Postfix parent process, or name=value 61 /* environment overrides. 62 /* .IP "\fBqueue_directory (see 'postconf -d' output)\fR" 63 /* The location of the Postfix top-level queue directory. 64 /* FILES 65 /* /var/spool/postfix/private, private class endpoints 66 /* /var/spool/postfix/public, public class endpoints 67 /* SEE ALSO 68 /* qmgr(8), queue manager trigger protocol 69 /* pickup(8), local pickup daemon 70 /* postconf(5), configuration parameters 71 /* LICENSE 72 /* .ad 73 /* .fi 74 /* The Secure Mailer license must be distributed with this software. 75 /* AUTHOR(S) 76 /* Wietse Venema 77 /* IBM T.J. Watson Research 78 /* P.O. Box 704 79 /* Yorktown Heights, NY 10598, USA 80 /* 81 /* Wietse Venema 82 /* Google, Inc. 83 /* 111 8th Avenue 84 /* New York, NY 10011, USA 85 /*--*/ 86 87 /* System library. */ 88 89 #include <sys_defs.h> 90 #include <sys/stat.h> 91 #include <fcntl.h> 92 #include <unistd.h> 93 #include <string.h> 94 #include <stdlib.h> 95 96 /* Utility library. */ 97 98 #include <msg.h> 99 #include <mymalloc.h> 100 #include <vstream.h> 101 #include <msg_vstream.h> 102 #include <safe.h> 103 #include <events.h> 104 #include <warn_stat.h> 105 #include <clean_env.h> 106 107 /* Global library. */ 108 109 #include <mail_proto.h> 110 #include <mail_params.h> 111 #include <mail_version.h> 112 #include <mail_conf.h> 113 #include <mail_parm_split.h> 114 115 static NORETURN usage(char *myname) 116 { 117 msg_fatal("usage: %s [-c config_dir] [-v] class service request", myname); 118 } 119 120 MAIL_VERSION_STAMP_DECLARE; 121 122 int main(int argc, char **argv) 123 { 124 char *class; 125 char *service; 126 char *request; 127 int fd; 128 struct stat st; 129 char *slash; 130 int c; 131 ARGV *import_env; 132 133 /* 134 * Fingerprint executables and core dumps. 135 */ 136 MAIL_VERSION_STAMP_ALLOCATE; 137 138 /* 139 * To minimize confusion, make sure that the standard file descriptors 140 * are open before opening anything else. XXX Work around for 44BSD where 141 * fstat can return EBADF on an open file descriptor. 142 */ 143 for (fd = 0; fd < 3; fd++) 144 if (fstat(fd, &st) == -1 145 && (close(fd), open("/dev/null", O_RDWR, 0)) != fd) 146 msg_fatal("open /dev/null: %m"); 147 148 /* 149 * Process environment options as early as we can. 150 */ 151 if (safe_getenv(CONF_ENV_VERB)) 152 msg_verbose = 1; 153 154 /* 155 * Initialize. Set up logging. Read the global configuration file after 156 * parsing command-line arguments. 157 */ 158 if ((slash = strrchr(argv[0], '/')) != 0 && slash[1]) 159 argv[0] = slash + 1; 160 msg_vstream_init(argv[0], VSTREAM_ERR); 161 set_mail_conf_str(VAR_PROCNAME, var_procname = mystrdup(argv[0])); 162 163 /* 164 * Parse JCL. 165 */ 166 while ((c = GETOPT(argc, argv, "c:v")) > 0) { 167 switch (c) { 168 default: 169 usage(argv[0]); 170 case 'c': 171 if (setenv(CONF_ENV_PATH, optarg, 1) < 0) 172 msg_fatal("out of memory"); 173 break; 174 case 'v': 175 msg_verbose++; 176 break; 177 } 178 } 179 if (argc != optind + 3) 180 usage(argv[0]); 181 class = argv[optind]; 182 service = argv[optind + 1]; 183 request = argv[optind + 2]; 184 185 /* 186 * Finish initializations. 187 */ 188 mail_conf_read(); 189 /* Enforce consistent operation of different Postfix parts. */ 190 import_env = mail_parm_split(VAR_IMPORT_ENVIRON, var_import_environ); 191 update_env(import_env->argv); 192 argv_free(import_env); 193 if (chdir(var_queue_dir)) 194 msg_fatal("chdir %s: %m", var_queue_dir); 195 196 /* 197 * Kick the service. 198 */ 199 if (mail_trigger(class, service, request, strlen(request)) < 0) { 200 msg_warn("Cannot contact class %s service %s - perhaps the mail system is down", 201 class, service); 202 exit(1); 203 } 204 205 /* 206 * Problem: With triggers over full duplex (i.e. non-FIFO) channels, we 207 * must avoid closing the channel before the server has received the 208 * request. Otherwise some hostile kernel may throw away the request. 209 * 210 * Solution: The trigger routine registers a read event handler that runs 211 * when the server closes the channel. The event_drain() routine waits 212 * for the event handler to run, but gives up when it takes too long. 213 */ 214 else { 215 event_drain(var_event_drain); 216 exit(0); 217 } 218 } 219