From: Lennart Poettering Date: Sun, 24 Dec 2017 15:50:19 +0000 (+0100) Subject: man: add a systemd-rc-local-generator(8) man page X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=45db187755fb7a63aa00bcc04fa9fac07a7ca5fa;p=elogind.git man: add a systemd-rc-local-generator(8) man page Most importantly, let's highlight the differences to the rc-local behaviour in SysV. Fixes: #7703 --- diff --git a/man/elogind-rc-local-generator.xml b/man/elogind-rc-local-generator.xml new file mode 100644 index 000000000..9292f5cee --- /dev/null +++ b/man/elogind-rc-local-generator.xml @@ -0,0 +1,86 @@ + + + + + + + + elogind-rc-local-generator + elogind + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + elogind-rc-local-generator + 8 + + + + elogind-rc-local-generator + Compatibility generator for starting /etc/rc.local and /usr/sbin/halt.local during boot and shutdown + + + + /usr/lib/elogind/system-generators/elogind-rc-local-generator + + + + Description + + elogind-rc-local-generator is a generator that checks whether + /etc/rc.local exists and is executable, and if it is pulls the + rc-local.service unit into the boot process. This unit is responsible for running this script + during late boot. Note that the script will be run with slightly different semantics than the original System V + version, which was run "last" in the boot process, which is a concept that does not translate to elogind. The + script is run after network.target, but in parallel with most other regular system + services. + + elogind-rc-local-generator also checks whether /usr/sbin/halt.local + exists and is executable, and if it is pulls the halt-local.service unit into the shutdown + process. This unit is responsible for running this script during later shutdown. + + Support for both /etc/rc.local and /usr/sbin/halt.local is provided + for compatibility with specific System V systems only. However, it is strongly recommended to avoid making use of + these scripts today, and instead provide proper unit files with appropriate dependencies for any scripts to run + during the boot or shutdown processes. + + elogind-rc-local-generator implements + elogind.generator7. + + + + See Also + + elogind1, + systemctl1 + + + + diff --git a/man/rules/meson.build b/man/rules/meson.build index 4a05b3c1a..ce08fd49d 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -1,11 +1,109 @@ # Do not edit. Generated by make-man-rules.py. manpages = [ -['elogind', '8', [], ''], - ['loginctl', '1', [], ''], - ['logind.conf', '5', [], ''], +['binfmt.d', '5', [], 'ENABLE_BINFMT'], + ['bootctl', '1', [], 'ENABLE_EFI'], + ['bootup', '7', [], ''], + ['busctl', '1', [], ''], + ['coredump.conf', '5', ['coredump.conf.d'], 'ENABLE_COREDUMP'], + ['coredumpctl', '1', [], 'ENABLE_COREDUMP'], + ['crypttab', '5', [], 'HAVE_LIBCRYPTSETUP'], + ['daemon', '7', [], ''], + ['dnssec-trust-anchors.d', + '5', + ['elogind.negative', 'elogind.positive'], + 'ENABLE_RESOLVE'], + ['environment.d', '5', [], 'ENABLE_ENVIRONMENT_D'], + ['file-hierarchy', '7', [], ''], + ['halt', '8', ['poweroff', 'reboot'], ''], + ['hostname', '5', [], ''], + ['hostnamectl', '1', [], 'ENABLE_HOSTNAMED'], + ['hwdb', '7', [], 'ENABLE_HWDB'], + ['journal-remote.conf', '5', ['journal-remote.conf.d'], 'HAVE_MICROHTTPD'], + ['journal-upload.conf', '5', ['journal-upload.conf.d'], 'HAVE_MICROHTTPD'], + ['journalctl', '1', [], ''], + ['journald.conf', '5', ['journald.conf.d'], ''], + ['kernel-command-line', '7', [], ''], + ['kernel-install', '8', [], ''], + ['libudev', '3', [], ''], + ['locale.conf', '5', [], ''], + ['localectl', '1', [], 'ENABLE_LOCALED'], + ['localtime', '5', [], ''], + ['loginctl', '1', [], 'ENABLE_LOGIND'], + ['logind.conf', '5', ['logind.conf.d'], 'ENABLE_LOGIND'], + ['machine-id', '5', [], ''], + ['machine-info', '5', [], ''], + ['machinectl', '1', [], 'ENABLE_MACHINED'], + ['modules-load.d', '5', [], 'HAVE_KMOD'], + ['networkctl', '1', [], 'ENABLE_NETWORKD'], + ['networkd.conf', '5', ['networkd.conf.d'], 'ENABLE_NETWORKD'], + ['nss-myhostname', '8', ['libnss_myhostname.so.2'], 'ENABLE_MYHOSTNAME'], + ['nss-mymachines', '8', ['libnss_mymachines.so.2'], 'ENABLE_MACHINED'], + ['nss-resolve', '8', ['libnss_resolve.so.2'], 'ENABLE_RESOLVE'], + ['nss-elogind', '8', ['libnss_elogind.so.2'], 'ENABLE_NSS_SYSTEMD'], + ['os-release', '5', [], ''], ['pam_elogind', '8', [], 'HAVE_PAM'], + ['resolved.conf', '5', ['resolved.conf.d'], 'ENABLE_RESOLVE'], + ['runlevel', '8', [], 'ENABLE_UTMP'], + ['sd-bus-errors', + '3', + ['SD_BUS_ERROR_ACCESS_DENIED', + 'SD_BUS_ERROR_ADDRESS_IN_USE', + 'SD_BUS_ERROR_AUTH_FAILED', + 'SD_BUS_ERROR_BAD_ADDRESS', + 'SD_BUS_ERROR_DISCONNECTED', + 'SD_BUS_ERROR_FAILED', + 'SD_BUS_ERROR_FILE_EXISTS', + 'SD_BUS_ERROR_FILE_NOT_FOUND', + 'SD_BUS_ERROR_INCONSISTENT_MESSAGE', + 'SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED', + 'SD_BUS_ERROR_INVALID_ARGS', + 'SD_BUS_ERROR_INVALID_SIGNATURE', + 'SD_BUS_ERROR_IO_ERROR', + 'SD_BUS_ERROR_LIMITS_EXCEEDED', + 'SD_BUS_ERROR_MATCH_RULE_INVALID', + 'SD_BUS_ERROR_MATCH_RULE_NOT_FOUND', + 'SD_BUS_ERROR_NAME_HAS_NO_OWNER', + 'SD_BUS_ERROR_NOT_SUPPORTED', + 'SD_BUS_ERROR_NO_MEMORY', + 'SD_BUS_ERROR_NO_NETWORK', + 'SD_BUS_ERROR_NO_REPLY', + 'SD_BUS_ERROR_NO_SERVER', + 'SD_BUS_ERROR_PROPERTY_READ_ONLY', + 'SD_BUS_ERROR_SERVICE_UNKNOWN', + 'SD_BUS_ERROR_TIMEOUT', + 'SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN', + 'SD_BUS_ERROR_UNKNOWN_INTERFACE', + 'SD_BUS_ERROR_UNKNOWN_METHOD', + 'SD_BUS_ERROR_UNKNOWN_OBJECT', + 'SD_BUS_ERROR_UNKNOWN_PROPERTY'], + ''], ['sd-bus', '3', [], ''], + ['sd-daemon', + '3', + ['SD_ALERT', + 'SD_CRIT', + 'SD_DEBUG', + 'SD_EMERG', + 'SD_ERR', + 'SD_INFO', + 'SD_NOTICE', + 'SD_WARNING'], + ''], ['sd-event', '3', [], ''], + ['sd-id128', + '3', + ['SD_ID128_CONST_STR', + 'SD_ID128_FORMAT_STR', + 'SD_ID128_FORMAT_VAL', + 'SD_ID128_MAKE', + 'SD_ID128_MAKE_STR', + 'SD_ID128_NULL', + 'sd_id128_equal', + 'sd_id128_is_null', + 'sd_id128_t'], + ''], + ['sd-journal', '3', [], ''], + ['sd-login', '3', [], 'HAVE_PAM'], ['sd_booted', '3', [], ''], ['sd_bus_add_match', '3', [], ''], ['sd_bus_creds_get_pid', @@ -242,6 +340,88 @@ manpages = [ 'sd_is_socket_unix', 'sd_is_special'], ''], + ['sd_journal_add_match', + '3', + ['sd_journal_add_conjunction', + 'sd_journal_add_disjunction', + 'sd_journal_flush_matches'], + ''], + ['sd_journal_enumerate_fields', + '3', + ['SD_JOURNAL_FOREACH_FIELD', 'sd_journal_restart_fields'], + ''], + ['sd_journal_get_catalog', '3', ['sd_journal_get_catalog_for_message_id'], ''], + ['sd_journal_get_cursor', '3', ['sd_journal_test_cursor'], ''], + ['sd_journal_get_cutoff_realtime_usec', + '3', + ['sd_journal_get_cutoff_monotonic_usec'], + ''], + ['sd_journal_get_data', + '3', + ['SD_JOURNAL_FOREACH_DATA', + 'sd_journal_enumerate_data', + 'sd_journal_get_data_threshold', + 'sd_journal_restart_data', + 'sd_journal_set_data_threshold'], + ''], + ['sd_journal_get_fd', + '3', + ['SD_JOURNAL_APPEND', + 'SD_JOURNAL_INVALIDATE', + 'SD_JOURNAL_NOP', + 'sd_journal_get_events', + 'sd_journal_get_timeout', + 'sd_journal_process', + 'sd_journal_reliable_fd', + 'sd_journal_wait'], + ''], + ['sd_journal_get_realtime_usec', '3', ['sd_journal_get_monotonic_usec'], ''], + ['sd_journal_get_usage', '3', [], ''], + ['sd_journal_has_runtime_files', '3', ['sd_journal_has_persistent_files'], ''], + ['sd_journal_next', + '3', + ['SD_JOURNAL_FOREACH', + 'SD_JOURNAL_FOREACH_BACKWARDS', + 'sd_journal_next_skip', + 'sd_journal_previous', + 'sd_journal_previous_skip'], + ''], + ['sd_journal_open', + '3', + ['SD_JOURNAL_CURRENT_USER', + 'SD_JOURNAL_LOCAL_ONLY', + 'SD_JOURNAL_OS_ROOT', + 'SD_JOURNAL_RUNTIME_ONLY', + 'SD_JOURNAL_SYSTEM', + 'sd_journal', + 'sd_journal_close', + 'sd_journal_open_directory', + 'sd_journal_open_directory_fd', + 'sd_journal_open_files', + 'sd_journal_open_files_fd'], + ''], + ['sd_journal_print', + '3', + ['SD_JOURNAL_SUPPRESS_LOCATION', + 'sd_journal_perror', + 'sd_journal_printv', + 'sd_journal_send', + 'sd_journal_sendv'], + ''], + ['sd_journal_query_unique', + '3', + ['SD_JOURNAL_FOREACH_UNIQUE', + 'sd_journal_enumerate_unique', + 'sd_journal_restart_unique'], + ''], + ['sd_journal_seek_head', + '3', + ['sd_journal_seek_cursor', + 'sd_journal_seek_monotonic_usec', + 'sd_journal_seek_realtime_usec', + 'sd_journal_seek_tail'], + ''], + ['sd_journal_stream_fd', '3', [], ''], ['sd_listen_fds', '3', ['SD_LISTEN_FDS_START', 'sd_listen_fds_with_names'], @@ -261,7 +441,7 @@ manpages = [ '3', ['sd_notifyf', 'sd_pid_notify', 'sd_pid_notify_with_fds', 'sd_pid_notifyf'], ''], - ['sd_pid_get_session', + ['sd_pid_get_owner_uid', '3', ['sd_peer_get_cgroup', 'sd_peer_get_machine_name', @@ -273,7 +453,7 @@ manpages = [ 'sd_peer_get_user_unit', 'sd_pid_get_cgroup', 'sd_pid_get_machine_name', - 'sd_pid_get_owner_uid', + 'sd_pid_get_session', 'sd_pid_get_slice', 'sd_pid_get_unit', 'sd_pid_get_user_slice', @@ -309,6 +489,287 @@ manpages = [ 'sd_uid_get_sessions', 'sd_uid_is_on_seat'], 'HAVE_PAM'], - ['sd_watchdog_enabled', '3', [], ''] + ['sd_watchdog_enabled', '3', [], ''], + ['shutdown', '8', [], ''], + ['sysctl.d', '5', [], ''], + ['systemctl', '1', [], ''], + ['elogind-analyze', '1', [], ''], + ['elogind-ask-password-console.service', + '8', + ['elogind-ask-password-console.path', + 'elogind-ask-password-wall.path', + 'elogind-ask-password-wall.service'], + ''], + ['elogind-ask-password', '1', [], ''], + ['elogind-backlight@.service', '8', ['elogind-backlight'], 'ENABLE_BACKLIGHT'], + ['elogind-binfmt.service', '8', ['elogind-binfmt'], 'ENABLE_BINFMT'], + ['elogind-cat', '1', [], ''], + ['elogind-cgls', '1', [], ''], + ['elogind-cgtop', '1', [], ''], + ['elogind-coredump', + '8', + ['elogind-coredump.socket', 'elogind-coredump@.service'], + 'ENABLE_COREDUMP'], + ['elogind-cryptsetup-generator', '8', [], 'HAVE_LIBCRYPTSETUP'], + ['elogind-cryptsetup@.service', + '8', + ['elogind-cryptsetup'], + 'HAVE_LIBCRYPTSETUP'], + ['elogind-debug-generator', '8', [], ''], + ['elogind-delta', '1', [], ''], + ['elogind-detect-virt', '1', [], ''], + ['elogind-environment-d-generator', + '8', + ['30-elogind-environment-d-generator'], + 'ENABLE_ENVIRONMENT_D'], + ['elogind-escape', '1', [], ''], + ['elogind-firstboot', '1', ['elogind-firstboot.service'], 'ENABLE_FIRSTBOOT'], + ['elogind-fsck@.service', + '8', + ['elogind-fsck', 'elogind-fsck-root.service'], + ''], + ['elogind-fstab-generator', '8', [], ''], + ['elogind-getty-generator', '8', [], ''], + ['elogind-gpt-auto-generator', '8', [], ''], + ['elogind-halt.service', + '8', + ['elogind-kexec.service', + 'elogind-poweroff.service', + 'elogind-reboot.service', + 'elogind-shutdown'], + ''], + ['elogind-hibernate-resume-generator', '8', [], 'ENABLE_HIBERNATE'], + ['elogind-hibernate-resume@.service', + '8', + ['elogind-hibernate-resume'], + 'ENABLE_HIBERNATE'], + ['elogind-hostnamed.service', '8', ['elogind-hostnamed'], 'ENABLE_HOSTNAMED'], + ['elogind-hwdb', '8', [], 'ENABLE_HWDB'], + ['elogind-importd.service', '8', ['elogind-importd'], 'ENABLE_IMPORTD'], + ['elogind-inhibit', '1', [], ''], + ['elogind-initctl.service', + '8', + ['elogind-initctl', 'elogind-initctl.socket'], + ''], + ['elogind-journal-gatewayd.service', + '8', + ['elogind-journal-gatewayd', 'elogind-journal-gatewayd.socket'], + 'HAVE_MICROHTTPD'], + ['elogind-journal-remote', '8', [], 'HAVE_MICROHTTPD'], + ['elogind-journal-upload', '8', [], 'HAVE_MICROHTTPD'], + ['elogind-journald.service', + '8', + ['elogind-journald', + 'elogind-journald-audit.socket', + 'elogind-journald-dev-log.socket', + 'elogind-journald.socket'], + ''], + ['elogind-localed.service', '8', ['elogind-localed'], 'ENABLE_LOCALED'], + ['elogind.service', '8', ['elogind'], 'ENABLE_LOGIND'], + ['elogind-machine-id-commit.service', '8', [], ''], + ['elogind-machine-id-setup', '1', [], ''], + ['elogind-machined.service', '8', ['elogind-machined'], 'ENABLE_MACHINED'], + ['elogind-makefs@.service', + '8', + ['elogind-growfs', + 'elogind-growfs@.service', + 'elogind-makefs', + 'elogind-makeswap@.service'], + ''], + ['elogind-modules-load.service', '8', ['elogind-modules-load'], 'HAVE_KMOD'], + ['elogind-mount', '1', ['elogind-umount'], ''], + ['elogind-networkd-wait-online.service', + '8', + ['elogind-networkd-wait-online'], + 'ENABLE_NETWORKD'], + ['elogind-networkd.service', '8', ['elogind-networkd'], 'ENABLE_NETWORKD'], + ['elogind-notify', '1', [], ''], + ['elogind-nspawn', '1', [], ''], + ['elogind-path', '1', [], ''], + ['elogind-quotacheck.service', + '8', + ['elogind-quotacheck'], + 'ENABLE_QUOTACHECK'], + ['elogind-random-seed.service', + '8', + ['elogind-random-seed'], + 'ENABLE_RANDOMSEED'], + ['elogind-rc-local-generator', '8', [], ''], + ['elogind-remount-fs.service', '8', ['elogind-remount-fs'], ''], + ['elogind-resolve', '1', [], 'ENABLE_RESOLVE'], + ['elogind-resolved.service', '8', ['elogind-resolved'], 'ENABLE_RESOLVE'], + ['elogind-rfkill.service', + '8', + ['elogind-rfkill', 'elogind-rfkill.socket'], + 'ENABLE_RFKILL'], + ['elogind-run', '1', [], ''], + ['elogind-sleep.conf', '5', ['sleep.conf.d'], ''], + ['elogind-socket-activate', '1', [], ''], + ['elogind-socket-proxyd', '8', [], ''], + ['elogind-suspend.service', + '8', + ['elogind-hibernate.service', + 'elogind-hybrid-sleep.service', + 'elogind-sleep'], + ''], + ['elogind-sysctl.service', '8', ['elogind-sysctl'], ''], + ['elogind-system-update-generator', '8', [], ''], + ['elogind-system.conf', + '5', + ['system.conf.d', 'elogind-user.conf', 'user.conf.d'], + ''], + ['elogind-sysusers', '8', ['elogind-sysusers.service'], ''], + ['elogind-sysv-generator', '8', [], 'HAVE_SYSV_COMPAT'], + ['elogind-timedated.service', '8', ['elogind-timedated'], 'ENABLE_TIMEDATED'], + ['elogind-timesyncd.service', '8', ['elogind-timesyncd'], 'ENABLE_TIMESYNCD'], + ['elogind-tmpfiles', + '8', + ['elogind-tmpfiles-clean.service', + 'elogind-tmpfiles-clean.timer', + 'elogind-tmpfiles-setup-dev.service', + 'elogind-tmpfiles-setup.service'], + ''], + ['elogind-tty-ask-password-agent', '1', [], ''], + ['elogind-udevd.service', + '8', + ['elogind-udevd', + 'elogind-udevd-control.socket', + 'elogind-udevd-kernel.socket'], + ''], + ['elogind-update-done.service', '8', ['elogind-update-done'], ''], + ['elogind-update-utmp.service', + '8', + ['elogind-update-utmp', 'elogind-update-utmp-runlevel.service'], + 'ENABLE_UTMP'], + ['elogind-user-sessions.service', '8', ['elogind-user-sessions'], 'HAVE_PAM'], + ['elogind-vconsole-setup.service', + '8', + ['elogind-vconsole-setup'], + 'ENABLE_VCONSOLE'], + ['elogind-veritysetup-generator', '8', [], 'HAVE_LIBCRYPTSETUP'], + ['elogind-veritysetup@.service', + '8', + ['elogind-veritysetup'], + 'HAVE_LIBCRYPTSETUP'], + ['elogind-volatile-root.service', '8', ['elogind-volatile-root'], ''], + ['elogind', '1', ['init'], ''], + ['elogind.automount', '5', [], ''], + ['elogind.device', '5', [], ''], + ['elogind.environment-generator', '7', [], 'ENABLE_ENVIRONMENT_D'], + ['elogind.exec', '5', [], ''], + ['elogind.generator', '7', [], ''], + ['elogind.journal-fields', '7', [], ''], + ['elogind.kill', '5', [], ''], + ['elogind.link', '5', [], ''], + ['elogind.mount', '5', [], ''], + ['elogind.netdev', '5', [], 'ENABLE_NETWORKD'], + ['elogind.dnssd', '5', [], 'ENABLE_RESOLVE'], + ['elogind.network', '5', [], 'ENABLE_NETWORKD'], + ['elogind.nspawn', '5', [], ''], + ['elogind.offline-updates', '7', [], ''], + ['elogind.path', '5', [], ''], + ['elogind.preset', '5', [], ''], + ['elogind.resource-control', '5', [], ''], + ['elogind.scope', '5', [], ''], + ['elogind.service', '5', [], ''], + ['elogind.slice', '5', [], ''], + ['elogind.socket', '5', [], ''], + ['elogind.special', '7', [], ''], + ['elogind.swap', '5', [], ''], + ['elogind.target', '5', [], ''], + ['elogind.time', '7', [], ''], + ['elogind.timer', '5', [], ''], + ['elogind.unit', '5', [], ''], + ['sysusers.d', '5', [], 'ENABLE_SYSUSERS'], + ['telinit', '8', [], ''], + ['timedatectl', '1', [], 'ENABLE_TIMEDATED'], + ['timesyncd.conf', '5', ['timesyncd.conf.d'], 'ENABLE_TIMESYNCD'], + ['tmpfiles.d', '5', [], ''], + ['udev', '7', [], ''], + ['udev.conf', '5', [], ''], + ['udev_device_get_syspath', + '3', + ['udev_device_get_action', + 'udev_device_get_devnode', + 'udev_device_get_devnum', + 'udev_device_get_devpath', + 'udev_device_get_devtype', + 'udev_device_get_driver', + 'udev_device_get_is_initialized', + 'udev_device_get_parent', + 'udev_device_get_parent_with_subsystem_devtype', + 'udev_device_get_subsystem', + 'udev_device_get_sysname', + 'udev_device_get_sysnum', + 'udev_device_get_udev'], + ''], + ['udev_device_has_tag', + '3', + ['udev_device_get_devlinks_list_entry', + 'udev_device_get_properties_list_entry', + 'udev_device_get_property_value', + 'udev_device_get_sysattr_list_entry', + 'udev_device_get_sysattr_value', + 'udev_device_get_tags_list_entry', + 'udev_device_set_sysattr_value'], + ''], + ['udev_device_new_from_syspath', + '3', + ['udev_device_new_from_device_id', + 'udev_device_new_from_devnum', + 'udev_device_new_from_environment', + 'udev_device_new_from_subsystem_sysname', + 'udev_device_ref', + 'udev_device_unref'], + ''], + ['udev_enumerate_add_match_subsystem', + '3', + ['udev_enumerate_add_match_is_initialized', + 'udev_enumerate_add_match_parent', + 'udev_enumerate_add_match_property', + 'udev_enumerate_add_match_sysattr', + 'udev_enumerate_add_match_sysname', + 'udev_enumerate_add_match_tag', + 'udev_enumerate_add_nomatch_subsystem', + 'udev_enumerate_add_nomatch_sysattr'], + ''], + ['udev_enumerate_new', + '3', + ['udev_enumerate_ref', 'udev_enumerate_unref'], + ''], + ['udev_enumerate_scan_devices', + '3', + ['udev_enumerate_add_syspath', + 'udev_enumerate_get_list_entry', + 'udev_enumerate_get_udev', + 'udev_enumerate_scan_subsystems'], + ''], + ['udev_list_entry', + '3', + ['udev_list_entry_get_by_name', + 'udev_list_entry_get_name', + 'udev_list_entry_get_next', + 'udev_list_entry_get_value'], + ''], + ['udev_monitor_filter_update', + '3', + ['udev_monitor_filter_add_match_subsystem_devtype', + 'udev_monitor_filter_add_match_tag', + 'udev_monitor_filter_remove'], + ''], + ['udev_monitor_new_from_netlink', + '3', + ['udev_monitor_ref', 'udev_monitor_unref'], + ''], + ['udev_monitor_receive_device', + '3', + ['udev_monitor_enable_receiving', + 'udev_monitor_get_fd', + 'udev_monitor_get_udev', + 'udev_monitor_set_receive_buffer_size'], + ''], + ['udev_new', '3', ['udev_ref', 'udev_unref'], ''], + ['udevadm', '8', [], ''], + ['vconsole.conf', '5', [], 'ENABLE_VCONSOLE'] ] # Really, do not edit.