// pidfd-kill is a command-line tool to send signals to processes using pidfds // passed through a unix socket. // // This tool is only intended to be used within runc's integration tests. package main import ( "context" "errors" "fmt" "net" "os" "os/signal" "github.com/urfave/cli/v3" "golang.org/x/sys/unix" "github.com/opencontainers/runc/internal/cmsg" ) const ( usage = `Open Container Initiative tests/cmd/pidfd-kill pidfd-kill is an implementation of a consumer of runC's --pidfd-socket API. After received SIGTERM, pidfd-kill sends the given signal to init process by pidfd received from --pidfd-socket. To use pidfd-kill, just specify a socket path at which you want to receive pidfd: $ pidfd-kill [--signal KILL] socket.sock ` ) func main() { app := &cli.Command{} app.Name = "pidfd-kill" app.Usage = usage app.Flags = []cli.Flag{ &cli.StringFlag{ Name: "signal", Value: "SIGKILL", Usage: "Signal to send to the init process", }, &cli.StringFlag{ Name: "pid-file", Value: "", Usage: "Path to write the pidfd-kill process ID to", }, } app.Action = func(_ context.Context, cmd *cli.Command) error { args := cmd.Args().Slice() if len(args) != 1 { return errors.New("required a single socket path") } socketFile := args[0] pidFile := cmd.String("pid-file") if pidFile != "" { pid := fmt.Sprintf("%d\n", os.Getpid()) if err := os.WriteFile(pidFile, []byte(pid), 0o644); err != nil { return err } defer os.Remove(pidFile) } sigStr := cmd.String("signal") if sigStr == "" { sigStr = "SIGKILL" } sig := unix.SignalNum(sigStr) pidfdFile, err := recvPidfd(socketFile) if err != nil { return err } defer pidfdFile.Close() signalCh := make(chan os.Signal, 16) signal.Notify(signalCh, unix.SIGTERM) <-signalCh return unix.PidfdSendSignal(int(pidfdFile.Fd()), sig, nil, 0) } if err := app.Run(context.Background(), os.Args); err != nil { fmt.Fprintln(os.Stderr, "fatal error:", err) os.Exit(1) } } func recvPidfd(socketFile string) (*os.File, error) { ln, err := net.Listen("unix", socketFile) if err != nil { return nil, err } defer ln.Close() conn, err := ln.Accept() if err != nil { return nil, err } defer conn.Close() socket, err := conn.(*net.UnixConn).File() if err != nil { return nil, err } defer socket.Close() return cmsg.RecvFile(socket) }