aboutsummaryrefslogtreecommitdiff
path: root/src/connection/fork.lisp
blob: 989668c12edf5aebe176739fe981520714352046 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
;;; Consfigurator -- Lisp declarative configuration management system

;;; Copyright (C) 2021  Sean Whitton <spwhitton@spwhitton.name>

;;; This file is free software; you can redistribute it and/or modify
;;; it under the terms of the GNU General Public License as published by
;;; the Free Software Foundation; either version 3, or (at your option)
;;; any later version.

;;; This file is distributed in the hope that it will be useful,
;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.

;;; You should have received a copy of the GNU General Public License
;;; along with this program.  If not, see <http://www.gnu.org/licenses/>.

(in-package :consfigurator.connection.fork)
(named-readtables:in-readtable :consfigurator)

;; Use only implementation-specific fork and waitpid calls to avoid thread
;; woes.  Things like chroot(2) and setuid(2), however, should be okay.

(defun fork ()
  #+sbcl (sb-posix:fork))

(defun waitpid (pid options)
  ;; normalise any other implementations such that we always return
  ;; (values PID EXIT-STATUS), as SB-POSIX:WAITPID does
  #+sbcl (sb-posix:waitpid pid options))

(defun wifexited (status)
  #+sbcl (sb-posix:wifexited status))

(defun wexitstatus (status)
  #+sbcl (sb-posix:wexitstatus status))

(defun can-probably-fork ()
  "Return nil if we can detect other running threads, and the Lisp
implementation is known not to support forking when there are other threads.
A return value other than nil indicates only that we couldn't detect
circumstances in which it is known that we cannot fork, not that we are sure
we can fork -- a thread might be only partly initialised at the time we check,
for example, such that we don't see it."
  (and
   #+sbcl (> 2 (length (sb-thread:list-all-threads)))))

(defclass fork-connection (lisp-connection) ())

(defgeneric post-fork (connection)
  (:documentation
   "Code to execute after forking but before calling CONTINUE-DEPLOY*."))

(defmethod continue-connection ((connection fork-connection) remaining)
  (unless (lisp-connection-p)
    (error "Forking requires a Lisp-type connection."))
  #-(or sbcl) (error "Don't know how to safely fork() in this Lisp")
  (upload-all-prerequisite-data
   :connection connection :upload-string-data nil)
  (mapc #'force-output
        (list *standard-output* *error-output* *debug-io* *terminal-io*))
  (let ((child (fork)))
    (case child
      ;; note that SB-POSIX:FORK can only return >=0
      (-1
       (error "fork(2) failed"))
      (0
       (handler-bind ((serious-condition
                        (lambda (c)
                          (trivial-backtrace:print-backtrace
                           c :output *error-output*)
                          (uiop:quit 2))))
         (mapc #'clear-input
               (list *standard-input* *debug-io* *terminal-io*))
         ;; While some kinds of data source will still work given certain
         ;; subtypes of FORK-CONNECTION (e.g. if they've already cached the
         ;; data in memory, or if it's also accessible to whomever we will
         ;; SETUID to), others won't, so drop all registrations and rely on
         ;; the call to UPLOAD-ALL-PREREQUISITE-DATA above.
         (reset-data-sources)
         (post-fork connection)
         ;; It would be nice to reenter Consfigurator's primary loop by
         ;; just calling (return-from establish-connection
         ;; (establish-connection :local)) here, but we need to kill
         ;; off the child afterwards, rather than returning to the
         ;; child's REPL or whatever else.
         (uiop:quit
          (if (eql :no-change (continue-deploy* remaining))
              0
              1))))
      (t
       (multiple-value-bind (pid status) (waitpid child 0)
         (declare (ignore pid))
         (let ((exited (wifexited status)))
           (unless exited
             (error
              "Fork connection child did not exit normally, status #x~(~4,'0X~)"
              status))
           (let ((exit-status (wexitstatus status)))
             (unless (< exit-status 2)
               (error
                "Fork connection child failed, exit code ~D" exit-status))
             (values nil (if (zerop status) :no-change nil)))))))))