Home | History | Annotate | Line # | Download | only in src 
      1 /*
      2  * Privilege Separation for dhcpcd
      3  * SPDX-License-Identifier: BSD-2-Clause
      4  * Copyright (c) 2006-2025 Roy Marples <roy (at) marples.name>
      5  * All rights reserved
      6 
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  *
     16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
     17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
     20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     26  * SUCH DAMAGE.
     27  */
     28 
     29 #ifndef PRIVSEP_ROOT_H
     30 #define PRIVSEP_ROOT_H
     31 
     32 #include "if.h"
     33 
     34 #if defined(PRIVSEP) && \
     35     (defined(HAVE_CAPSICUM) || defined(__linux__) || defined(__sun))
     36 #define PRIVSEP_GETIFADDRS
     37 #endif
     38 
     39 pid_t ps_root_start(struct dhcpcd_ctx *ctx);
     40 void ps_root_close(struct dhcpcd_ctx *ctx);
     41 int ps_root_stop(struct dhcpcd_ctx *ctx);
     42 void ps_root_signalcb(int, void *);
     43 
     44 ssize_t ps_root_readerror(struct dhcpcd_ctx *, void *, size_t);
     45 ssize_t ps_root_mreaderror(struct dhcpcd_ctx *, void **, size_t *);
     46 ssize_t ps_root_ioctl(struct dhcpcd_ctx *, ioctl_request_t, void *, size_t);
     47 ssize_t ps_root_unlink(struct dhcpcd_ctx *, const char *);
     48 ssize_t ps_root_filemtime(struct dhcpcd_ctx *, const char *, time_t *);
     49 ssize_t ps_root_readfile(struct dhcpcd_ctx *, const char *, void **, size_t *);
     50 ssize_t ps_root_writefile(struct dhcpcd_ctx *, const char *, mode_t,
     51     const void *, size_t);
     52 ssize_t ps_root_logreopen(struct dhcpcd_ctx *);
     53 ssize_t ps_root_script(struct dhcpcd_ctx *, const void *, size_t);
     54 ssize_t ps_root_stopprocesses(struct dhcpcd_ctx *);
     55 int ps_root_getauthrdm(struct dhcpcd_ctx *, uint64_t *);
     56 ssize_t ps_root_user_ingroup(struct dhcpcd_ctx *, uid_t, gid_t, gid_t);
     57 #ifdef PRIVSEP_GETHOSTNAME
     58 int ps_root_gethostname(struct dhcpcd_ctx *, char *, size_t);
     59 #endif
     60 #ifdef PRIVSEP_GETIFADDRS
     61 int ps_root_getifaddrs(struct dhcpcd_ctx *, struct ifaddrs **);
     62 #endif
     63 
     64 ssize_t ps_root_os(struct dhcpcd_ctx *, struct ps_msghdr *, struct msghdr *,
     65     void **, size_t *, bool *);
     66 #if defined(BSD) || defined(__sun)
     67 ssize_t ps_root_route(struct dhcpcd_ctx *, void *, size_t);
     68 ssize_t ps_root_ioctllink(struct dhcpcd_ctx *, unsigned long, void *, size_t);
     69 ssize_t ps_root_ioctl6(struct dhcpcd_ctx *, unsigned long, void *, size_t);
     70 ssize_t ps_root_indirectioctl(struct dhcpcd_ctx *, unsigned long, const char *,
     71     void *, size_t);
     72 ssize_t ps_root_ifignoregroup(struct dhcpcd_ctx *, const char *);
     73 ssize_t ps_root_sysctl(struct dhcpcd_ctx *, const int *, unsigned int, void *,
     74     size_t *, const void *, size_t);
     75 #endif
     76 #ifdef __linux__
     77 ssize_t ps_root_sendnetlink(struct dhcpcd_ctx *, int, struct msghdr *);
     78 #endif
     79 
     80 #ifdef PLUGIN_DEV
     81 int ps_root_dev_initialised(struct dhcpcd_ctx *, const char *);
     82 int ps_root_dev_listening(struct dhcpcd_ctx *);
     83 #endif
     84 
     85 #endif
     86