Home | History | Annotate | Line # | Download | only in master 
      1 /*	$NetBSD: master_service.c,v 1.2 2025/02/25 19:15:46 christos Exp $	*/
      2 
      3 /*++
      4 /* NAME
      5 /*	master_service 3
      6 /* SUMMARY
      7 /*	Postfix master - start/stop services
      8 /* SYNOPSIS
      9 /*	#include "master.h"
     10 /*
     11 /*	void	master_start_service(serv)
     12 /*	MASTER_SERV *serv;
     13 /*
     14 /*	void	master_stop_service(serv)
     15 /*	MASTER_SERV *serv;
     16 /*
     17 /*	void	master_restart_service(serv, conf_reload)
     18 /*	MASTER_SERV *serv;
     19 /*	int	conf_reload;
     20 /* DESCRIPTION
     21 /*	master_start_service() enables the named service.
     22 /*
     23 /*	master_stop_service() disables named service.
     24 /*
     25 /*	master_restart_service() requests all running child processes to
     26 /*	commit suicide.  The conf_reload argument is either DO_CONF_RELOAD
     27 /*	(configuration files were reloaded, re-evaluate the child process
     28 /*	creation policy) or NO_CONF_RELOAD.
     29 /* DIAGNOSTICS
     30 /* BUGS
     31 /* SEE ALSO
     32 /*	master_avail(3), process creation policy
     33 /*	master_wakeup(3), service automatic wakeup
     34 /*	master_status(3), child status reports
     35 /*	master_listen(3), unix/inet listeners
     36 /* LICENSE
     37 /* .ad
     38 /* .fi
     39 /*	The Secure Mailer license must be distributed with this software.
     40 /* AUTHOR(S)
     41 /*	Wietse Venema
     42 /*	IBM T.J. Watson Research
     43 /*	P.O. Box 704
     44 /*	Yorktown Heights, NY 10598, USA
     45 /*--*/
     46 
     47 /* System libraries. */
     48 
     49 #include <sys_defs.h>
     50 #include <string.h>
     51 #include <unistd.h>
     52 
     53 /* Utility library. */
     54 
     55 #include <msg.h>
     56 #include <mymalloc.h>
     57 
     58 /* Application-specific. */
     59 
     60 #include "master.h"
     61 
     62 MASTER_SERV *master_head;
     63 
     64 /* master_start_service - activate service */
     65 
     66 void    master_start_service(MASTER_SERV *serv)
     67 {
     68 
     69     /*
     70      * Enable connection requests, wakeup timers, and status updates from
     71      * child processes.
     72      */
     73     master_listen_init(serv);
     74     master_avail_listen(serv);
     75     master_status_init(serv);
     76     master_wakeup_init(serv);
     77 }
     78 
     79 /* master_stop_service - deactivate service */
     80 
     81 void    master_stop_service(MASTER_SERV *serv)
     82 {
     83 
     84     /*
     85      * Undo the things that master_start_service() did.
     86      */
     87     master_wakeup_cleanup(serv);
     88     master_status_cleanup(serv);
     89     master_avail_cleanup(serv);
     90     master_listen_cleanup(serv);
     91 }
     92 
     93 /* master_restart_service - restart service after configuration reload */
     94 
     95 void    master_restart_service(MASTER_SERV *serv, int conf_reload)
     96 {
     97 
     98     /*
     99      * Undo some of the things that master_start_service() did.
    100      */
    101     master_wakeup_cleanup(serv);
    102     master_status_cleanup(serv);
    103 
    104     /*
    105      * Now undo the undone.
    106      */
    107     master_status_init(serv);
    108     master_wakeup_init(serv);
    109 
    110     /*
    111      * Respond to configuration change.
    112      */
    113     if (conf_reload)
    114 	master_avail_listen(serv);
    115 }
    116