summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLuke Shumaker <lukeshu@lukeshu.com>2018-09-05 00:02:09 -0400
committerLuke Shumaker <lukeshu@lukeshu.com>2018-09-05 00:08:33 -0400
commitce07ec5e3d5888a5068dff408c47cc9fef91f4b1 (patch)
tree2c013fbe6952a42b97ba63b9c4171aaee914783c
parent5eb4559beef25554da16fd61fd0c30e9957a19c1 (diff)
sd_daemon: Update exit-status.go
- Add sysexits.h codes - Sync with systemd v239, don't mask deprecated systemd codes * Unmask _EXIT_RESERVED -> EXIT_TCPWRAP * Note that EXIT_MAKE_STARTER was dropped in SD v235 * Renumber EXIT_SMACK_PROCESS_LABEL from 237 to 236, replacing EXIT_BUS_ENDPOINT * Add EXIT_KEYRING at 237, EXIT_SMACK_PROCESS_LABEL's old number * Add everything 238 and up - Add comments about what versions of systemd handle the systemd codes - Update the LSB URL from LSB 3.1.1 to LSB 5.0.0
-rw-r--r--sd_daemon/exit-status.go136
1 files changed, 88 insertions, 48 deletions
diff --git a/sd_daemon/exit-status.go b/sd_daemon/exit-status.go
index 47c5745..b7fd305 100644
--- a/sd_daemon/exit-status.go
+++ b/sd_daemon/exit-status.go
@@ -1,4 +1,4 @@
-// Copyright 2015-2016 Luke Shumaker
+// Copyright 2015-2016, 2018 Luke Shumaker
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -19,11 +19,26 @@ import (
"os"
)
-// systemd daemon(7) recommends using the exit codes defined in the
-// "LSB recomendations for SysV init scripts"[1].
+// daemon(7) recommends using the exit codes defined in the "LSB
+// recomendations for SysV init scripts"[1].
//
-// [1]: http://refspecs.linuxbase.org/LSB_3.1.1/LSB-Core-generic/LSB-Core-generic/iniscrptact.html
+// BSD sysexits.h (which is also in GNU libc) defines several exit
+// codes in the range 64-78. These are typically used in the context
+// of mail delivery; originating with BSD delivermail (the NCP
+// predecessor to the TCP/IP sendmail), and are still used by modern
+// mail systems such as Postfix to interpret the local(8) delivery
+// agent's exit status. Using these for service exit codes isn't
+// recommended by LSB (which says they are in the range reserved for
+// future LSB use) or by daemon(7). However, they are used in
+// practice, and are recognized by systemd.
+//
+// [1]: http://refspecs.linuxbase.org/LSB_5.0.0/LSB-Core-generic/LSB-Core-generic/iniscrptact.html
+//
+// sysexits(3): https://www.freebsd.org/cgi/man.cgi?query=sysexits
+//
+// local(8): http://www.postfix.org/local.8.html
const (
+ // 0- 8 are currently defined by LSB.
EXIT_SUCCESS uint8 = 0
EXIT_FAILURE uint8 = 1
EXIT_INVALIDARGUMENT uint8 = 2
@@ -32,51 +47,76 @@ const (
EXIT_NOTINSTALLED uint8 = 5
EXIT_NOTCONFIGURED uint8 = 6
EXIT_NOTRUNNING uint8 = 7
- // 8- 99 are reserved for future LSB use
- // 100-149 are reserved for distribution use
- // 150-199 are reserved for application use
- // 200-254 are reserved for init system use
//
- // Therefore, the following are taken from systemd's
- // `src/basic/exit-status.h`
- EXIT_CHDIR uint8 = 200
- EXIT_NICE uint8 = 201
- EXIT_FDS uint8 = 202
- EXIT_EXEC uint8 = 203
- EXIT_MEMORY uint8 = 204
- EXIT_LIMITS uint8 = 205
- EXIT_OOM_ADJUST uint8 = 206
- EXIT_SIGNAL_MASK uint8 = 207
- EXIT_STDIN uint8 = 208
- EXIT_STDOUT uint8 = 209
- EXIT_CHROOT uint8 = 210
- EXIT_IOPRIO uint8 = 211
- EXIT_TIMERSLACK uint8 = 212
- EXIT_SECUREBITS uint8 = 213
- EXIT_SETSCHEDULER uint8 = 214
- EXIT_CPUAFFINITY uint8 = 215
- EXIT_GROUP uint8 = 216
- EXIT_USER uint8 = 217
- EXIT_CAPABILITIES uint8 = 218
- EXIT_CGROUP uint8 = 219
- EXIT_SETSID uint8 = 220
- EXIT_CONFIRM uint8 = 221
- EXIT_STDERR uint8 = 222
- _EXIT_RESERVED uint8 = 223 // used to be tcpwrap don't reuse!
- EXIT_PAM uint8 = 224
- EXIT_NETWORK uint8 = 225
- EXIT_NAMESPACE uint8 = 226
- EXIT_NO_NEW_PRIVILEGES uint8 = 227
- EXIT_SECCOMP uint8 = 228
- EXIT_SELINUX_CONTEXT uint8 = 229
- EXIT_PERSONALITY uint8 = 230
- EXIT_APPARMOR_PROFILE uint8 = 231
- EXIT_ADDRESS_FAMILIES uint8 = 232
- EXIT_RUNTIME_DIRECTORY uint8 = 233
- EXIT_MAKE_STARTER uint8 = 234
- EXIT_CHOWN uint8 = 235
- EXIT_BUS_ENDPOINT uint8 = 236
- EXIT_SMACK_PROCESS_LABEL uint8 = 237
+ // 8- 99 are reserved for future LSB use.
+ // However, let's provide the EX_ codes from
+ // sysexits.h anyway.
+ EX_OK uint8 = EXIT_SUCCESS
+ EX_USAGE uint8 = 64 // command line usage error
+ EX_DATAERR uint8 = 65 // data format error
+ EX_NOINPUT uint8 = 66 // cannot open input
+ EX_NOUSER uint8 = 67 // addressee unknown
+ EX_NOHOST uint8 = 68 // host name unknown
+ EX_UNAVAILABLE uint8 = 69 // service unavailable
+ EX_SOFTWARE uint8 = 70 // internal software error
+ EX_OSERR uint8 = 71 // system error (e.g., can't fork)
+ EX_OSFILE uint8 = 72 // critical OS file missing
+ EX_CANTCREAT uint8 = 73 // can't create (user) output file
+ EX_IOERR uint8 = 74 // input/output error
+ EX_TEMPFAIL uint8 = 75 // temp failure; user is invited to retry
+ EX_PROTOCOL uint8 = 76 // remote error in protocol
+ EX_NOPERM uint8 = 77 // permission denied
+ EX_CONFIG uint8 = 78 // configuration error
+ //
+ // 100-149 are reserved for distribution use.
+ //
+ // 150-199 are reserved for application use.
+ //
+ // 200-254 are reserved (for init system use).
+ // So, take codes 200+ from systemd's
+ // `src/basic/exit-status.h`
+ EXIT_CHDIR uint8 = 200 // SD v8+
+ EXIT_NICE uint8 = 201 // SD v8+
+ EXIT_FDS uint8 = 202 // SD v8+
+ EXIT_EXEC uint8 = 203 // SD v8+
+ EXIT_MEMORY uint8 = 204 // SD v8+
+ EXIT_LIMITS uint8 = 205 // SD v8+
+ EXIT_OOM_ADJUST uint8 = 206 // SD v8+
+ EXIT_SIGNAL_MASK uint8 = 207 // SD v8+
+ EXIT_STDIN uint8 = 208 // SD v8+
+ EXIT_STDOUT uint8 = 209 // SD v8+
+ EXIT_CHROOT uint8 = 210 // SD v8+
+ EXIT_IOPRIO uint8 = 211 // SD v8+
+ EXIT_TIMERSLACK uint8 = 212 // SD v8+
+ EXIT_SECUREBITS uint8 = 213 // SD v8+
+ EXIT_SETSCHEDULER uint8 = 214 // SD v8+
+ EXIT_CPUAFFINITY uint8 = 215 // SD v8+
+ EXIT_GROUP uint8 = 216 // SD v8+
+ EXIT_USER uint8 = 217 // SD v8+
+ EXIT_CAPABILITIES uint8 = 218 // SD v8+
+ EXIT_CGROUP uint8 = 219 // SD v8+
+ EXIT_SETSID uint8 = 220 // SD v8+
+ EXIT_CONFIRM uint8 = 221 // SD v8+
+ EXIT_STDERR uint8 = 222 // SD v8+
+ EXIT_TCPWRAP uint8 = 223 // SD v8-v211
+ EXIT_PAM uint8 = 224 // SD v8+
+ EXIT_NETWORK uint8 = 225 // SD v33+
+ EXIT_NAMESPACE uint8 = 226 // SD v38+
+ EXIT_NO_NEW_PRIVILEGES uint8 = 227 // SD v187+
+ EXIT_SECCOMP uint8 = 228 // SD v187+
+ EXIT_SELINUX_CONTEXT uint8 = 229 // SD v209+
+ EXIT_PERSONALITY uint8 = 230 // SD v209+
+ EXIT_APPARMOR_PROFILE uint8 = 231 // SD v210+
+ EXIT_ADDRESS_FAMILIES uint8 = 232 // SD v211+
+ EXIT_RUNTIME_DIRECTORY uint8 = 233 // SD v211+
+ EXIT_MAKE_STARTER uint8 = 234 // SD v214-v234
+ EXIT_CHOWN uint8 = 235 // SD v214+
+ EXIT_SMACK_PROCESS_LABEL uint8 = 236 // SD v230+; was BUS_ENDPOINT in SD v217-v229
+ EXIT_KEYRING uint8 = 237 // SD v233+; was SMACK_PROCESS_LABEL in SD v218-v229
+ EXIT_STATE_DIRECTORY uint8 = 238 // SD v235+
+ EXIT_CACHE_DIRECTORY uint8 = 239 // SD v235+
+ EXIT_LOGS_DIRECTORY uint8 = 240 // SD v235+
+ EXIT_CONFIGURATION_DIRECTORY uint8 = 241 // SD v235+
)
// Recover is a utility function to defer at the beginning of a