mirror of
https://git.proxmox.com/git/systemd
synced 2025-07-27 12:31:02 +00:00
Imported Upstream version 217
This commit is contained in:
Martin Pitt
parent
e842803ae5
commit
5eef597e93
144
Makefile-man.am
144
Makefile-man.am
@ -23,7 +23,6 @@ MANPAGES += \
|
||||
man/machine-id.5 \
|
||||
man/machine-info.5 \
|
||||
man/os-release.5 \
|
||||
man/runlevel.8 \
|
||||
man/sd-daemon.3 \
|
||||
man/sd-id128.3 \
|
||||
man/sd-journal.3 \
|
||||
@ -47,6 +46,7 @@ MANPAGES += \
|
||||
man/sd_journal_seek_head.3 \
|
||||
man/sd_journal_stream_fd.3 \
|
||||
man/sd_listen_fds.3 \
|
||||
man/sd_machine_get_class.3 \
|
||||
man/sd_notify.3 \
|
||||
man/sd_watchdog_enabled.3 \
|
||||
man/shutdown.8 \
|
||||
@ -63,11 +63,15 @@ MANPAGES += \
|
||||
man/systemd-delta.1 \
|
||||
man/systemd-detect-virt.1 \
|
||||
man/systemd-efi-boot-generator.8 \
|
||||
man/systemd-escape.1 \
|
||||
man/systemd-firstboot.1 \
|
||||
man/systemd-fsck@.service.8 \
|
||||
man/systemd-fstab-generator.8 \
|
||||
man/systemd-getty-generator.8 \
|
||||
man/systemd-gpt-auto-generator.8 \
|
||||
man/systemd-halt.service.8 \
|
||||
man/systemd-hibernate-resume-generator.8 \
|
||||
man/systemd-hibernate-resume@.service.8 \
|
||||
man/systemd-inhibit.1 \
|
||||
man/systemd-initctl.service.8 \
|
||||
man/systemd-journald.service.8 \
|
||||
@ -89,7 +93,6 @@ MANPAGES += \
|
||||
man/systemd-tty-ask-password-agent.1 \
|
||||
man/systemd-udevd.service.8 \
|
||||
man/systemd-update-done.service.8 \
|
||||
man/systemd-update-utmp.service.8 \
|
||||
man/systemd.1 \
|
||||
man/systemd.automount.5 \
|
||||
man/systemd.device.5 \
|
||||
@ -116,6 +119,7 @@ MANPAGES += \
|
||||
man/telinit.8 \
|
||||
man/tmpfiles.d.5 \
|
||||
man/udev.7 \
|
||||
man/udev.conf.5 \
|
||||
man/udevadm.8
|
||||
MANPAGES_ALIAS += \
|
||||
man/SD_ALERT.3 \
|
||||
@ -189,12 +193,15 @@ MANPAGES_ALIAS += \
|
||||
man/sd_journal_set_data_threshold.3 \
|
||||
man/sd_journal_test_cursor.3 \
|
||||
man/sd_journal_wait.3 \
|
||||
man/sd_machine_get_ifindices.3 \
|
||||
man/sd_notifyf.3 \
|
||||
man/systemd-ask-password-console.path.8 \
|
||||
man/systemd-ask-password-wall.path.8 \
|
||||
man/systemd-ask-password-wall.service.8 \
|
||||
man/systemd-firstboot.service.1 \
|
||||
man/systemd-fsck-root.service.8 \
|
||||
man/systemd-fsck.8 \
|
||||
man/systemd-hibernate-resume.8 \
|
||||
man/systemd-hibernate.service.8 \
|
||||
man/systemd-hybrid-sleep.service.8 \
|
||||
man/systemd-initctl.8 \
|
||||
@ -220,8 +227,6 @@ MANPAGES_ALIAS += \
|
||||
man/systemd-udevd-kernel.socket.8 \
|
||||
man/systemd-udevd.8 \
|
||||
man/systemd-update-done.8 \
|
||||
man/systemd-update-utmp-runlevel.service.8 \
|
||||
man/systemd-update-utmp.8 \
|
||||
man/systemd-user.conf.5
|
||||
man/SD_ALERT.3: man/sd-daemon.3
|
||||
man/SD_CRIT.3: man/sd-daemon.3
|
||||
@ -294,12 +299,15 @@ man/sd_journal_sendv.3: man/sd_journal_print.3
|
||||
man/sd_journal_set_data_threshold.3: man/sd_journal_get_data.3
|
||||
man/sd_journal_test_cursor.3: man/sd_journal_get_cursor.3
|
||||
man/sd_journal_wait.3: man/sd_journal_get_fd.3
|
||||
man/sd_machine_get_ifindices.3: man/sd_machine_get_class.3
|
||||
man/sd_notifyf.3: man/sd_notify.3
|
||||
man/systemd-ask-password-console.path.8: man/systemd-ask-password-console.service.8
|
||||
man/systemd-ask-password-wall.path.8: man/systemd-ask-password-console.service.8
|
||||
man/systemd-ask-password-wall.service.8: man/systemd-ask-password-console.service.8
|
||||
man/systemd-firstboot.service.1: man/systemd-firstboot.1
|
||||
man/systemd-fsck-root.service.8: man/systemd-fsck@.service.8
|
||||
man/systemd-fsck.8: man/systemd-fsck@.service.8
|
||||
man/systemd-hibernate-resume.8: man/systemd-hibernate-resume@.service.8
|
||||
man/systemd-hibernate.service.8: man/systemd-suspend.service.8
|
||||
man/systemd-hybrid-sleep.service.8: man/systemd-suspend.service.8
|
||||
man/systemd-initctl.8: man/systemd-initctl.service.8
|
||||
@ -325,8 +333,6 @@ man/systemd-udevd-control.socket.8: man/systemd-udevd.service.8
|
||||
man/systemd-udevd-kernel.socket.8: man/systemd-udevd.service.8
|
||||
man/systemd-udevd.8: man/systemd-udevd.service.8
|
||||
man/systemd-update-done.8: man/systemd-update-done.service.8
|
||||
man/systemd-update-utmp-runlevel.service.8: man/systemd-update-utmp.service.8
|
||||
man/systemd-update-utmp.8: man/systemd-update-utmp.service.8
|
||||
man/systemd-user.conf.5: man/systemd-system.conf.5
|
||||
man/SD_ALERT.html: man/sd-daemon.html
|
||||
$(html-alias)
|
||||
@ -541,6 +547,9 @@ man/sd_journal_test_cursor.html: man/sd_journal_get_cursor.html
|
||||
man/sd_journal_wait.html: man/sd_journal_get_fd.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_machine_get_ifindices.html: man/sd_machine_get_class.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_notifyf.html: man/sd_notify.html
|
||||
$(html-alias)
|
||||
|
||||
@ -553,12 +562,18 @@ man/systemd-ask-password-wall.path.html: man/systemd-ask-password-console.servic
|
||||
man/systemd-ask-password-wall.service.html: man/systemd-ask-password-console.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-firstboot.service.html: man/systemd-firstboot.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-fsck-root.service.html: man/systemd-fsck@.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-fsck.html: man/systemd-fsck@.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-hibernate-resume.html: man/systemd-hibernate-resume@.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-hibernate.service.html: man/systemd-suspend.service.html
|
||||
$(html-alias)
|
||||
|
||||
@ -634,12 +649,6 @@ man/systemd-udevd.html: man/systemd-udevd.service.html
|
||||
man/systemd-update-done.html: man/systemd-update-done.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-update-utmp-runlevel.service.html: man/systemd-update-utmp.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-update-utmp.html: man/systemd-update-utmp.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-user.conf.html: man/systemd-system.conf.html
|
||||
$(html-alias)
|
||||
|
||||
@ -680,7 +689,8 @@ endif
|
||||
if ENABLE_COREDUMP
|
||||
MANPAGES += \
|
||||
man/coredump.conf.5 \
|
||||
man/coredumpctl.1
|
||||
man/coredumpctl.1 \
|
||||
man/systemd-coredump.8
|
||||
MANPAGES_ALIAS += \
|
||||
#
|
||||
|
||||
@ -725,8 +735,13 @@ MANPAGES += \
|
||||
man/sd_bus_open_user.3 \
|
||||
man/sd_bus_path_encode.3 \
|
||||
man/sd_bus_request_name.3 \
|
||||
man/sd_event_add_child.3 \
|
||||
man/sd_event_add_defer.3 \
|
||||
man/sd_event_add_signal.3 \
|
||||
man/sd_event_add_time.3 \
|
||||
man/sd_event_get_fd.3 \
|
||||
man/sd_event_new.3 \
|
||||
man/sd_event_set_name.3 \
|
||||
man/systemd-bus-proxyd.8 \
|
||||
man/systemd-bus-proxyd@.service.8
|
||||
MANPAGES_ALIAS += \
|
||||
@ -735,6 +750,7 @@ MANPAGES_ALIAS += \
|
||||
man/sd_bus_creds_get_cgroup.3 \
|
||||
man/sd_bus_creds_get_cmdline.3 \
|
||||
man/sd_bus_creds_get_comm.3 \
|
||||
man/sd_bus_creds_get_connection_name.3 \
|
||||
man/sd_bus_creds_get_exe.3 \
|
||||
man/sd_bus_creds_get_gid.3 \
|
||||
man/sd_bus_creds_get_mask.3 \
|
||||
@ -784,8 +800,13 @@ MANPAGES_ALIAS += \
|
||||
man/sd_bus_ref.3 \
|
||||
man/sd_bus_release_name.3 \
|
||||
man/sd_bus_unref.3 \
|
||||
man/sd_event_add_exit.3 \
|
||||
man/sd_event_add_post.3 \
|
||||
man/sd_event_default.3 \
|
||||
man/sd_event_get_name.3 \
|
||||
man/sd_event_ref.3 \
|
||||
man/sd_event_source_get_child_pid.3 \
|
||||
man/sd_event_source_get_signal.3 \
|
||||
man/sd_event_source_get_time.3 \
|
||||
man/sd_event_source_get_time_accuracy.3 \
|
||||
man/sd_event_source_get_time_clock.3 \
|
||||
@ -798,6 +819,7 @@ man/sd_bus_creds_get_audit_session_id.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_cgroup.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_cmdline.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_comm.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_connection_name.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_exe.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_gid.3: man/sd_bus_creds_get_pid.3
|
||||
man/sd_bus_creds_get_mask.3: man/sd_bus_creds_new_from_pid.3
|
||||
@ -847,8 +869,13 @@ man/sd_bus_path_decode.3: man/sd_bus_path_encode.3
|
||||
man/sd_bus_ref.3: man/sd_bus_new.3
|
||||
man/sd_bus_release_name.3: man/sd_bus_request_name.3
|
||||
man/sd_bus_unref.3: man/sd_bus_new.3
|
||||
man/sd_event_add_exit.3: man/sd_event_add_defer.3
|
||||
man/sd_event_add_post.3: man/sd_event_add_defer.3
|
||||
man/sd_event_default.3: man/sd_event_new.3
|
||||
man/sd_event_get_name.3: man/sd_event_set_name.3
|
||||
man/sd_event_ref.3: man/sd_event_new.3
|
||||
man/sd_event_source_get_child_pid.3: man/sd_event_add_child.3
|
||||
man/sd_event_source_get_signal.3: man/sd_event_add_signal.3
|
||||
man/sd_event_source_get_time.3: man/sd_event_add_time.3
|
||||
man/sd_event_source_get_time_accuracy.3: man/sd_event_add_time.3
|
||||
man/sd_event_source_get_time_clock.3: man/sd_event_add_time.3
|
||||
@ -871,6 +898,9 @@ man/sd_bus_creds_get_cmdline.html: man/sd_bus_creds_get_pid.html
|
||||
man/sd_bus_creds_get_comm.html: man/sd_bus_creds_get_pid.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_bus_creds_get_connection_name.html: man/sd_bus_creds_get_pid.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_bus_creds_get_exe.html: man/sd_bus_creds_get_pid.html
|
||||
$(html-alias)
|
||||
|
||||
@ -1018,12 +1048,27 @@ man/sd_bus_release_name.html: man/sd_bus_request_name.html
|
||||
man/sd_bus_unref.html: man/sd_bus_new.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_add_exit.html: man/sd_event_add_defer.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_add_post.html: man/sd_event_add_defer.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_default.html: man/sd_event_new.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_get_name.html: man/sd_event_set_name.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_ref.html: man/sd_event_new.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_source_get_child_pid.html: man/sd_event_add_child.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_source_get_signal.html: man/sd_event_add_signal.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_event_source_get_time.html: man/sd_event_add_time.html
|
||||
$(html-alias)
|
||||
|
||||
@ -1125,34 +1170,6 @@ man/systemd-random-seed.html: man/systemd-random-seed.service.html
|
||||
|
||||
endif
|
||||
|
||||
if ENABLE_READAHEAD
|
||||
MANPAGES += \
|
||||
man/sd-readahead.3 \
|
||||
man/sd_readahead.3 \
|
||||
man/systemd-readahead-replay.service.8
|
||||
MANPAGES_ALIAS += \
|
||||
man/systemd-readahead-collect.service.8 \
|
||||
man/systemd-readahead-done.service.8 \
|
||||
man/systemd-readahead-done.timer.8 \
|
||||
man/systemd-readahead.8
|
||||
man/systemd-readahead-collect.service.8: man/systemd-readahead-replay.service.8
|
||||
man/systemd-readahead-done.service.8: man/systemd-readahead-replay.service.8
|
||||
man/systemd-readahead-done.timer.8: man/systemd-readahead-replay.service.8
|
||||
man/systemd-readahead.8: man/systemd-readahead-replay.service.8
|
||||
man/systemd-readahead-collect.service.html: man/systemd-readahead-replay.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-readahead-done.service.html: man/systemd-readahead-replay.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-readahead-done.timer.html: man/systemd-readahead-replay.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-readahead.html: man/systemd-readahead-replay.service.html
|
||||
$(html-alias)
|
||||
|
||||
endif
|
||||
|
||||
if ENABLE_RESOLVED
|
||||
MANPAGES += \
|
||||
man/resolved.conf.5 \
|
||||
@ -1190,7 +1207,8 @@ endif
|
||||
|
||||
if ENABLE_TIMESYNCD
|
||||
MANPAGES += \
|
||||
man/systemd-timesyncd.service.8
|
||||
man/systemd-timesyncd.service.8 \
|
||||
man/timesyncd.conf.5
|
||||
MANPAGES_ALIAS += \
|
||||
man/systemd-timesyncd.8
|
||||
man/systemd-timesyncd.8: man/systemd-timesyncd.service.8
|
||||
@ -1239,7 +1257,8 @@ endif
|
||||
if HAVE_MICROHTTPD
|
||||
MANPAGES += \
|
||||
man/systemd-journal-gatewayd.service.8 \
|
||||
man/systemd-journal-remote.8
|
||||
man/systemd-journal-remote.8 \
|
||||
man/systemd-journal-upload.8
|
||||
MANPAGES_ALIAS += \
|
||||
man/systemd-journal-gatewayd.8 \
|
||||
man/systemd-journal-gatewayd.socket.8
|
||||
@ -1299,6 +1318,7 @@ MANPAGES_ALIAS += \
|
||||
man/sd_seat_can_tty.3 \
|
||||
man/sd_seat_get_sessions.3 \
|
||||
man/sd_session_get_class.3 \
|
||||
man/sd_session_get_desktop.3 \
|
||||
man/sd_session_get_display.3 \
|
||||
man/sd_session_get_remote_host.3 \
|
||||
man/sd_session_get_remote_user.3 \
|
||||
@ -1340,6 +1360,7 @@ man/sd_seat_can_multi_session.3: man/sd_seat_get_active.3
|
||||
man/sd_seat_can_tty.3: man/sd_seat_get_active.3
|
||||
man/sd_seat_get_sessions.3: man/sd_seat_get_active.3
|
||||
man/sd_session_get_class.3: man/sd_session_is_active.3
|
||||
man/sd_session_get_desktop.3: man/sd_session_is_active.3
|
||||
man/sd_session_get_display.3: man/sd_session_is_active.3
|
||||
man/sd_session_get_remote_host.3: man/sd_session_is_active.3
|
||||
man/sd_session_get_remote_user.3: man/sd_session_is_active.3
|
||||
@ -1431,6 +1452,9 @@ man/sd_seat_get_sessions.html: man/sd_seat_get_active.html
|
||||
man/sd_session_get_class.html: man/sd_session_is_active.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_session_get_desktop.html: man/sd_session_is_active.html
|
||||
$(html-alias)
|
||||
|
||||
man/sd_session_get_display.html: man/sd_session_is_active.html
|
||||
$(html-alias)
|
||||
|
||||
@ -1491,6 +1515,23 @@ MANPAGES_ALIAS += \
|
||||
|
||||
endif
|
||||
|
||||
if HAVE_UTMP
|
||||
MANPAGES += \
|
||||
man/runlevel.8 \
|
||||
man/systemd-update-utmp.service.8
|
||||
MANPAGES_ALIAS += \
|
||||
man/systemd-update-utmp-runlevel.service.8 \
|
||||
man/systemd-update-utmp.8
|
||||
man/systemd-update-utmp-runlevel.service.8: man/systemd-update-utmp.service.8
|
||||
man/systemd-update-utmp.8: man/systemd-update-utmp.service.8
|
||||
man/systemd-update-utmp-runlevel.service.html: man/systemd-update-utmp.service.html
|
||||
$(html-alias)
|
||||
|
||||
man/systemd-update-utmp.html: man/systemd-update-utmp.service.html
|
||||
$(html-alias)
|
||||
|
||||
endif
|
||||
|
||||
# Really, do not edit this file.
|
||||
|
||||
EXTRA_DIST += \
|
||||
@ -1531,7 +1572,6 @@ EXTRA_DIST += \
|
||||
man/sd-id128.xml \
|
||||
man/sd-journal.xml \
|
||||
man/sd-login.xml \
|
||||
man/sd-readahead.xml \
|
||||
man/sd_booted.xml \
|
||||
man/sd_bus_creds_get_pid.xml \
|
||||
man/sd_bus_creds_new_from_pid.xml \
|
||||
@ -1548,8 +1588,13 @@ EXTRA_DIST += \
|
||||
man/sd_bus_open_user.xml \
|
||||
man/sd_bus_path_encode.xml \
|
||||
man/sd_bus_request_name.xml \
|
||||
man/sd_event_add_child.xml \
|
||||
man/sd_event_add_defer.xml \
|
||||
man/sd_event_add_signal.xml \
|
||||
man/sd_event_add_time.xml \
|
||||
man/sd_event_get_fd.xml \
|
||||
man/sd_event_new.xml \
|
||||
man/sd_event_set_name.xml \
|
||||
man/sd_get_seats.xml \
|
||||
man/sd_id128_get_machine.xml \
|
||||
man/sd_id128_randomize.xml \
|
||||
@ -1571,9 +1616,9 @@ EXTRA_DIST += \
|
||||
man/sd_journal_stream_fd.xml \
|
||||
man/sd_listen_fds.xml \
|
||||
man/sd_login_monitor_new.xml \
|
||||
man/sd_machine_get_class.xml \
|
||||
man/sd_notify.xml \
|
||||
man/sd_pid_get_session.xml \
|
||||
man/sd_readahead.xml \
|
||||
man/sd_seat_get_active.xml \
|
||||
man/sd_session_is_active.xml \
|
||||
man/sd_uid_get_state.xml \
|
||||
@ -1594,22 +1639,28 @@ EXTRA_DIST += \
|
||||
man/systemd-cat.xml \
|
||||
man/systemd-cgls.xml \
|
||||
man/systemd-cgtop.xml \
|
||||
man/systemd-coredump.xml \
|
||||
man/systemd-cryptsetup-generator.xml \
|
||||
man/systemd-cryptsetup@.service.xml \
|
||||
man/systemd-debug-generator.xml \
|
||||
man/systemd-delta.xml \
|
||||
man/systemd-detect-virt.xml \
|
||||
man/systemd-efi-boot-generator.xml \
|
||||
man/systemd-escape.xml \
|
||||
man/systemd-firstboot.xml \
|
||||
man/systemd-fsck@.service.xml \
|
||||
man/systemd-fstab-generator.xml \
|
||||
man/systemd-getty-generator.xml \
|
||||
man/systemd-gpt-auto-generator.xml \
|
||||
man/systemd-halt.service.xml \
|
||||
man/systemd-hibernate-resume-generator.xml \
|
||||
man/systemd-hibernate-resume@.service.xml \
|
||||
man/systemd-hostnamed.service.xml \
|
||||
man/systemd-inhibit.xml \
|
||||
man/systemd-initctl.service.xml \
|
||||
man/systemd-journal-gatewayd.service.xml \
|
||||
man/systemd-journal-remote.xml \
|
||||
man/systemd-journal-upload.xml \
|
||||
man/systemd-journald.service.xml \
|
||||
man/systemd-localed.service.xml \
|
||||
man/systemd-logind.service.xml \
|
||||
@ -1623,7 +1674,6 @@ EXTRA_DIST += \
|
||||
man/systemd-path.xml \
|
||||
man/systemd-quotacheck.service.xml \
|
||||
man/systemd-random-seed.service.xml \
|
||||
man/systemd-readahead-replay.service.xml \
|
||||
man/systemd-remount-fs.service.xml \
|
||||
man/systemd-resolved.service.xml \
|
||||
man/systemd-rfkill@.service.xml \
|
||||
@ -1674,7 +1724,9 @@ EXTRA_DIST += \
|
||||
man/sysusers.d.xml \
|
||||
man/telinit.xml \
|
||||
man/timedatectl.xml \
|
||||
man/timesyncd.conf.xml \
|
||||
man/tmpfiles.d.xml \
|
||||
man/udev.conf.xml \
|
||||
man/udev.xml \
|
||||
man/udevadm.xml \
|
||||
man/user-system-options.xml \
|
||||
|
||||
1121
Makefile.am
1121
Makefile.am
File diff suppressed because it is too large
Load Diff
5425
Makefile.in
5425
Makefile.in
File diff suppressed because it is too large
Load Diff
415
NEWS
415
NEWS
@ -1,5 +1,414 @@
|
||||
systemd System and Service Manager
|
||||
|
||||
CHANGES WITH 217:
|
||||
|
||||
* journalctl gained the new options -t/--identifier= to match
|
||||
on the syslog identifier (aka "tag"), as well as --utc to
|
||||
show log timestamps in the UTC timezone. journalctl now also
|
||||
accepts -n/--lines=all to disable line capping in a pager.
|
||||
|
||||
* Services can notify the manager before they start a reload
|
||||
(by sending RELOADING=1) or shutdown (by sending
|
||||
STOPPING=1). This allows the manager to track and show the
|
||||
internal state of daemons and closes a race condition when
|
||||
the process is still running but has closed its D-Bus
|
||||
connection.
|
||||
|
||||
* Services with Type=oneshot do not have to have any ExecStart
|
||||
commands anymore.
|
||||
|
||||
* User units are now loaded also from
|
||||
$XDG_RUNTIME_DIR/systemd/user/. This is similar to the
|
||||
/run/systemd/user directory that was already previously
|
||||
supported, but is under the control of the user.
|
||||
|
||||
* Job timeouts (i.e. time-outs on the time a job that is
|
||||
queued stays in the run queue) can now optionally result in
|
||||
immediate reboot or power-off actions (JobTimeoutAction= and
|
||||
JobTimeoutRebootArgument=). This is useful on ".target"
|
||||
units, to limit the maximum time a target remains
|
||||
undispatched in the run queue, and to trigger an emergency
|
||||
operation in such a case. This is now used by default to
|
||||
turn off the system if boot-up (as defined by everything in
|
||||
basic.target) hangs and does not complete for at least
|
||||
15min. Also, if power-off or reboot hang for at least 30min
|
||||
an immediate power-off/reboot operation is triggered. This
|
||||
functionality is particularly useful to increase reliability
|
||||
on embedded devices, but also on laptops which might
|
||||
accidentally get powered on when carried in a backpack and
|
||||
whose boot stays stuck in a hard disk encryption passphrase
|
||||
question.
|
||||
|
||||
* systemd-logind can be configured to also handle lid switch
|
||||
events even when the machine is docked or multiple displays
|
||||
are attached (HandleLidSwitchDocked= option).
|
||||
|
||||
* A helper binary and a service have been added which can be
|
||||
used to resume from hibernation in the initramfs. A
|
||||
generator will parse the resume= option on the kernel
|
||||
command-line to trigger resume.
|
||||
|
||||
* A user console daemon systemd-consoled has been
|
||||
added. Currently, it is a preview, and will so far open a
|
||||
single terminal on each session of the user marked as
|
||||
Desktop=systemd-console.
|
||||
|
||||
* Route metrics can be specified for DHCP routes added by
|
||||
systemd-networkd.
|
||||
|
||||
* The SELinux context of socket-activated services can be set
|
||||
from the information provided by the networking stack
|
||||
(SELinuxContextFromNet= option).
|
||||
|
||||
* Userspace firmware loading support has been removed and
|
||||
the minimum supported kernel version is thus bumped to 3.7.
|
||||
|
||||
* Timeout for udev workers has been increased from 1 to 3
|
||||
minutes, but a warning will be printed after 1 minute to
|
||||
help diagnose kernel modules that take a long time to load.
|
||||
|
||||
* Udev rules can now remove tags on devices with TAG-="foobar".
|
||||
|
||||
* systemd's readahead implementation has been removed. In many
|
||||
circumstances it didn't give expected benefits even for
|
||||
rotational disk drives and was becoming less relevant in the
|
||||
age of SSDs. As none of the developers has been using
|
||||
rotating media anymore, and nobody stepped up to actively
|
||||
maintain this component of systemd it has now been removed.
|
||||
|
||||
* Swap units can use Discard= to specify discard options.
|
||||
Discard options specified for swaps in /etc/fstab are now
|
||||
respected.
|
||||
|
||||
* Docker containers are now detected as a separate type of
|
||||
virtualization.
|
||||
|
||||
* The Password Agent protocol gained support for queries where
|
||||
the user input is shown, useful e.g. for user names.
|
||||
systemd-ask-password gained a new --echo option to turn that
|
||||
on.
|
||||
|
||||
* The default sysctl.d/ snippets will now set:
|
||||
|
||||
net.core.default_qdisc = fq_codel
|
||||
|
||||
This selects Fair Queuing Controlled Delay as the default
|
||||
queuing discipline for network interfaces. fq_codel helps
|
||||
fight the network bufferbloat problem. It is believed to be
|
||||
a good default with no tuning required for most workloads.
|
||||
Downstream distributions may override this choice. On 10Gbit
|
||||
servers that do not do forwarding, "fq" may perform better.
|
||||
Systems without a good clocksource should use "pfifo_fast".
|
||||
|
||||
* If kdbus is enabled during build a new option BusPolicy= is
|
||||
available for service units, that allows locking all service
|
||||
processes into a stricter bus policy, in order to limit
|
||||
access to various bus services, or even hide most of them
|
||||
from the service's view entirely.
|
||||
|
||||
* networkctl will now show the .network and .link file
|
||||
networkd has applied to a specific interface.
|
||||
|
||||
* sd-login gained a new API call sd_session_get_desktop() to
|
||||
query which desktop environment has been selected for a
|
||||
session.
|
||||
|
||||
* UNIX utmp support is now compile-time optional to support
|
||||
legacy-free systems.
|
||||
|
||||
* systemctl gained two new commands "add-wants" and
|
||||
"add-requires" for pulling in units from specific targets
|
||||
easily.
|
||||
|
||||
* If the word "rescue" is specified on the kernel command line
|
||||
the system will now boot into rescue mode (aka
|
||||
rescue.target), which was previously available only by
|
||||
specifying "1" or "systemd.unit=rescue.target" on the kernel
|
||||
command line. This new kernel command line option nicely
|
||||
mirrors the already existing "emergency" kernel command line
|
||||
option.
|
||||
|
||||
* New kernel command line options mount.usr=, mount.usrflags=,
|
||||
mount.usrfstype= have been added that match root=, rootflags=,
|
||||
rootfstype= but allow mounting a specific file system to
|
||||
/usr.
|
||||
|
||||
* The $NOTIFY_SOCKET is now also passed to control processes of
|
||||
services, not only the main process.
|
||||
|
||||
* This version reenables support for fsck's -l switch. This
|
||||
means at least version v2.25 of util-linux is required for
|
||||
operation, otherwise dead-locks on device nodes may
|
||||
occur. Again: you need to update util-linux to at least
|
||||
v2.25 when updating systemd to v217.
|
||||
|
||||
* The "multi-seat-x" tool has been removed from systemd, as
|
||||
its functionality has been integrated into X servers 1.16,
|
||||
and the tool is hence redundant. It is recommended to update
|
||||
display managers invoking this tool to simply invoke X
|
||||
directly from now on, again.
|
||||
|
||||
* Support for the new ALLOW_INTERACTIVE_AUTHORIZATION D-Bus
|
||||
message flag has been added for all of systemd's PolicyKit
|
||||
authenticated method calls has been added. In particular
|
||||
this now allows optional interactive authorization via
|
||||
PolicyKit for many of PID1's privileged operations such as
|
||||
unit file enabling and disabling.
|
||||
|
||||
* "udevadm hwdb --update" learnt a new switch "--usr" for
|
||||
placing the rebuilt hardware database in /usr instead of
|
||||
/etc. When used only hardware database entries stored in
|
||||
/usr will be used, and any user database entries in /etc are
|
||||
ignored. This functionality is useful for vendors to ship a
|
||||
pre-built database on systems where local configuration is
|
||||
unnecessary or unlikely.
|
||||
|
||||
* Calendar time specifications in .timer units now also
|
||||
understand the strings "semi-annually", "quarterly" and
|
||||
"minutely" as shortcuts (in addition to the preexisting
|
||||
"anually", "hourly", ...).
|
||||
|
||||
* systemd-tmpfiles will now correctly create files in /dev
|
||||
at boot which are marked for creation only at boot. It is
|
||||
recommended to always create static device nodes with 'c!'
|
||||
and 'b!', so that they are created only at boot and not
|
||||
overwritten at runtime.
|
||||
|
||||
* When the watchdog logic is used for a service (WatchdogSec=)
|
||||
and the watchdog timeout is hit the service will now be
|
||||
terminated with SIGABRT (instead of just SIGTERM), in order
|
||||
to make sure a proper coredump and backtrace is
|
||||
generated. This ensures that hanging services will result in
|
||||
similar coredump/backtrace behaviour as services that hit a
|
||||
segmentation fault.
|
||||
|
||||
Contributions from: Andreas Henriksson, Andrei Borzenkov,
|
||||
Angus Gibson, Ansgar Burchardt, Ben Wolsieffer, Brandon L.
|
||||
Black, Christian Hesse, Cristian Rodríguez, Daniel Buch,
|
||||
Daniele Medri, Daniel Mack, Dan Williams, Dave Reisner, David
|
||||
Herrmann, David Sommerseth, David Strauss, Emil Renner
|
||||
Berthing, Eric Cook, Evangelos Foutras, Filipe Brandenburger,
|
||||
Gustavo Sverzut Barbieri, Hans de Goede, Harald Hoyer, Hristo
|
||||
Venev, Hugo Grostabussiat, Ivan Shapovalov, Jan Janssen, Jan
|
||||
Synacek, Jonathan Liu, Juho Son, Karel Zak, Kay Sievers, Klaus
|
||||
Purer, Koen Kooi, Lennart Poettering, Lukas Nykryn, Lukasz
|
||||
Skalski, Łukasz Stelmach, Mantas Mikulėnas, Marcel Holtmann,
|
||||
Marius Tessmann, Marko Myllynen, Martin Pitt, Michael Biebl,
|
||||
Michael Marineau, Michael Olbrich, Michael Scherer, Michal
|
||||
Schmidt, Michal Sekletar, Miroslav Lichvar, Patrik Flykt,
|
||||
Philippe De Swert, Piotr Drąg, Rahul Sundaram, Richard
|
||||
Weinberger, Robert Milasan, Ronny Chevalier, Ruben Kerkhof,
|
||||
Santiago Vila, Sergey Ptashnick, Simon McVittie, Sjoerd
|
||||
Simons, Stefan Brüns, Steven Allen, Steven Noonan, Susant
|
||||
Sahani, Sylvain Plantefève, Thomas Hindoe Paaboel Andersen,
|
||||
Timofey Titovets, Tobias Hunger, Tom Gundersen, Torstein
|
||||
Husebø, Umut Tezduyar Lindskog, WaLyong Cho, Zbigniew
|
||||
Jędrzejewski-Szmek.
|
||||
|
||||
-- Berlin, 2014-10-28
|
||||
|
||||
CHANGES WITH 216:
|
||||
|
||||
* timedated no longer reads NTP implementation unit names from
|
||||
/usr/lib/systemd/ntp-units.d/*.list. Alternative NTP
|
||||
implementations should add a
|
||||
|
||||
Conflicts=systemd-timesyncd.service
|
||||
|
||||
to their unit files to take over and replace systemd's NTP
|
||||
default functionality.
|
||||
|
||||
* systemd-sysusers gained a new line type "r" for configuring
|
||||
which UID/GID ranges to allocate system users/groups
|
||||
from. Lines of type "u" may now add an additional column
|
||||
that specifies the home directory for the system user to be
|
||||
created. Also, systemd-sysusers may now optionally read user
|
||||
information from STDIN instead of a file. This is useful for
|
||||
invoking it from RPM preinst scriptlets that need to create
|
||||
users before the first RPM file is installed since these
|
||||
files might need to be owned by them. A new
|
||||
%sysusers_create_inline RPM macro has been introduced to do
|
||||
just that. systemd-sysusers now updates the shadow files as
|
||||
well as the user/group databases, which should enhance
|
||||
compatibility with certain tools like grpck.
|
||||
|
||||
* A number of bus APIs of PID 1 now optionally consult
|
||||
PolicyKit to permit access for otherwise unprivileged
|
||||
clients under certain conditions. Note that this currently
|
||||
doesn't support interactive authentication yet, but this is
|
||||
expected to be added eventually, too.
|
||||
|
||||
* /etc/machine-info now has new fields for configuring the
|
||||
deployment environment of the machine, as well as the
|
||||
location of the machine. hostnamectl has been updated with
|
||||
new command to update these fields.
|
||||
|
||||
* systemd-timesyncd has been updated to automatically acquire
|
||||
NTP server information from systemd-networkd, which might
|
||||
have been discovered via DHCP.
|
||||
|
||||
* systemd-resolved now includes a caching DNS stub resolver
|
||||
and a complete LLMNR name resolution implementation. A new
|
||||
NSS module "nss-resolve" has been added which can be used
|
||||
instead of glibc's own "nss-dns" to resolve hostnames via
|
||||
systemd-resolved. Hostnames, addresses and arbitrary RRs may
|
||||
be resolved via systemd-resolved D-Bus APIs. In contrast to
|
||||
the glibc internal resolver systemd-resolved is aware of
|
||||
multi-homed system, and keeps DNS server and caches separate
|
||||
and per-interface. Queries are sent simultaneously on all
|
||||
interfaces that have DNS servers configured, in order to
|
||||
properly handle VPNs and local LANs which might resolve
|
||||
separate sets of domain names. systemd-resolved may acquire
|
||||
DNS server information from systemd-networkd automatically,
|
||||
which in turn might have discovered them via DHCP. A tool
|
||||
"systemd-resolve-host" has been added that may be used to
|
||||
query the DNS logic in resolved. systemd-resolved implements
|
||||
IDNA and automatically uses IDNA or UTF-8 encoding depending
|
||||
on whether classic DNS or LLMNR is used as transport. In the
|
||||
next releases we intend to add a DNSSEC and mDNS/DNS-SD
|
||||
implementation to systemd-resolved.
|
||||
|
||||
* A new NSS module nss-mymachines has been added, that
|
||||
automatically resolves the names of all local registered
|
||||
containers to their respective IP addresses.
|
||||
|
||||
* A new client tool "networkctl" for systemd-networkd has been
|
||||
added. It currently is entirely passive and will query
|
||||
networking configuration from udev, rtnetlink and networkd,
|
||||
and present it to the user in a very friendly
|
||||
way. Eventually, we hope to extend it to become a full
|
||||
control utility for networkd.
|
||||
|
||||
* .socket units gained a new DeferAcceptSec= setting that
|
||||
controls the kernels' TCP_DEFER_ACCEPT sockopt for
|
||||
TCP. Similar, support for controlling TCP keep-alive
|
||||
settings has been added (KeepAliveTimeSec=,
|
||||
KeepAliveIntervalSec=, KeepAliveProbes=). Also, support for
|
||||
turning off Nagle's algorithm on TCP has been added
|
||||
(NoDelay=).
|
||||
|
||||
* logind learned a new session type "web", for use in projects
|
||||
like Cockpit which register web clients as PAM sessions.
|
||||
|
||||
* timer units with at least one OnCalendar= setting will now
|
||||
be started only after timer-sync.target has been
|
||||
reached. This way they will not elapse before the system
|
||||
clock has been corrected by a local NTP client or
|
||||
similar. This is particular useful on RTC-less embedded
|
||||
machines, that come up with an invalid system clock.
|
||||
|
||||
* systemd-nspawn's --network-veth= switch should now result in
|
||||
stable MAC addresses for both the outer and the inner side
|
||||
of the link.
|
||||
|
||||
* systemd-nspawn gained a new --volatile= switch for running
|
||||
container instances with /etc or /var unpopulated.
|
||||
|
||||
* The kdbus client code has been updated to use the new Linux
|
||||
3.17 memfd subsystem instead of the old kdbus-specific one.
|
||||
|
||||
* systemd-networkd's DHCP client and server now support
|
||||
FORCERENEW. There are also new configuration options to
|
||||
configure the vendor client identifier and broadcast mode
|
||||
for DHCP.
|
||||
|
||||
* systemd will no longer inform the kernel about the current
|
||||
timezone, as this is necessarily incorrect and racy as the
|
||||
kernel has no understanding of DST and similar
|
||||
concepts. This hence means FAT timestamps will be always
|
||||
considered UTC, similar to what Android is already
|
||||
doing. Also, when the RTC is configured to the local time
|
||||
(rather than UTC) systemd will never synchronize back to it,
|
||||
as this might confuse Windows at a later boot.
|
||||
|
||||
* systemd-analyze gained a new command "verify" for offline
|
||||
validation of unit files.
|
||||
|
||||
* systemd-networkd gained support for a couple of additional
|
||||
settings for bonding networking setups. Also, the metric for
|
||||
statically configured routes may now be configured. For
|
||||
network interfaces where this is appropriate the peer IP
|
||||
address may now be configured.
|
||||
|
||||
* systemd-networkd's DHCP client will no longer request
|
||||
broadcasting by default, as this tripped up some networks.
|
||||
For hardware where broadcast is required the feature should
|
||||
be switched back on using RequestBroadcast=yes.
|
||||
|
||||
* systemd-networkd will now set up IPv4LL addresses (when
|
||||
enabled) even if DHCP is configured successfully.
|
||||
|
||||
* udev will now default to respect network device names given
|
||||
by the kernel when the kernel indicates that these are
|
||||
predictable. This behavior can be tweaked by changing
|
||||
NamePolicy= in the relevant .link file.
|
||||
|
||||
* A new library systemd-terminal has been added that
|
||||
implements full TTY stream parsing and rendering. This
|
||||
library is supposed to be used later on for implementing a
|
||||
full userspace VT subsystem, replacing the current kernel
|
||||
implementation.
|
||||
|
||||
* A new tool systemd-journal-upload has been added to push
|
||||
journal data to a remote system running
|
||||
systemd-journal-remote.
|
||||
|
||||
* journald will no longer forward all local data to another
|
||||
running syslog daemon. This change has been made because
|
||||
rsyslog (which appears to be the most commonly used syslog
|
||||
implementation these days) no longer makes use of this, and
|
||||
instead pulls the data out of the journal on its own. Since
|
||||
forwarding the messages to a non-existent syslog server is
|
||||
more expensive than we assumed we have now turned this
|
||||
off. If you run a syslog server that is not a recent rsyslog
|
||||
version, you have to turn this option on again
|
||||
(ForwardToSyslog= in journald.conf).
|
||||
|
||||
* journald now optionally supports the LZ4 compressor for
|
||||
larger journal fields. This compressor should perform much
|
||||
better than XZ which was the previous default.
|
||||
|
||||
* machinectl now shows the IP addresses of local containers,
|
||||
if it knows them, plus the interface name of the container.
|
||||
|
||||
* A new tool "systemd-escape" has been added that makes it
|
||||
easy to escape strings to build unit names and similar.
|
||||
|
||||
* sd_notify() messages may now include a new ERRNO= field
|
||||
which is parsed and collected by systemd and shown among the
|
||||
"systemctl status" output for a service.
|
||||
|
||||
* A new component "systemd-firstboot" has been added that
|
||||
queries the most basic systemd information (timezone,
|
||||
hostname, root password) interactively on first
|
||||
boot. Alternatively it may also be used to provision these
|
||||
things offline on OS images installed into directories.
|
||||
|
||||
* The default sysctl.d/ snippets will now set
|
||||
|
||||
net.ipv4.conf.default.promote_secondaries=1
|
||||
|
||||
This has the benefit of no flushing secondary IP addresses
|
||||
when primary addresses are removed.
|
||||
|
||||
Contributions from: Ansgar Burchardt, Bastien Nocera, Colin
|
||||
Walters, Dan Dedrick, Daniel Buch, Daniel Korostil, Daniel
|
||||
Mack, Dan Williams, Dave Reisner, David Herrmann, Denis
|
||||
Kenzior, Eelco Dolstra, Eric Cook, Hannes Reinecke, Harald
|
||||
Hoyer, Hong Shick Pak, Hui Wang, Jean-André Santoni, Jóhann
|
||||
B. Guðmundsson, Jon Severinsson, Karel Zak, Kay Sievers, Kevin
|
||||
Wells, Lennart Poettering, Lukas Nykryn, Mantas Mikulėnas,
|
||||
Marc-Antoine Perennou, Martin Pitt, Michael Biebl, Michael
|
||||
Marineau, Michael Olbrich, Michal Schmidt, Michal Sekletar,
|
||||
Miguel Angel Ajo, Mike Gilbert, Olivier Brunel, Robert
|
||||
Schiele, Ronny Chevalier, Simon McVittie, Sjoerd Simons, Stef
|
||||
Walter, Steven Noonan, Susant Sahani, Tanu Kaskinen, Thomas
|
||||
Blume, Thomas Hindoe Paaboel Andersen, Timofey Titovets,
|
||||
Tobias Geerinckx-Rice, Tomasz Torcz, Tom Gundersen, Umut
|
||||
Tezduyar Lindskog, Zbigniew Jędrzejewski-Szmek
|
||||
|
||||
-- Berlin, 2014-08-19
|
||||
|
||||
CHANGES WITH 215:
|
||||
|
||||
* A new tool systemd-sysusers has been added. This tool
|
||||
@ -292,7 +701,7 @@ CHANGES WITH 214:
|
||||
moved to /run/systemd/resolve/. If you have a symlink from
|
||||
/etc/resolv.conf, it might be necessary to correct it.
|
||||
|
||||
* Two new service settings, ProtectedHome= and ProtectedSystem=,
|
||||
* Two new service settings, ProtectHome= and ProtectSystem=,
|
||||
have been added. When enabled, they will make the user data
|
||||
(such as /home) inaccessible or read-only and the system
|
||||
(such as /usr) read-only, for specific services. This allows
|
||||
@ -404,7 +813,7 @@ CHANGES WITH 214:
|
||||
|
||||
* Access modes specified in tmpfiles snippets may now be
|
||||
prefixed with "~", which indicates that they shall be masked
|
||||
by whether the existing file or directly is currently
|
||||
by whether the existing file or directory is currently
|
||||
writable, readable or executable at all. Also, if specified,
|
||||
the sgid/suid/sticky bits will be masked for all
|
||||
non-directories.
|
||||
@ -1411,7 +1820,7 @@ CHANGES WITH 208:
|
||||
kernel, and on seats that are not seat0.
|
||||
|
||||
* A new kernel command line option luks.options= is understood
|
||||
now which allows specifiying LUKS options for usage for LUKS
|
||||
now which allows specifying LUKS options for usage for LUKS
|
||||
encrypted partitions specified with luks.uuid=.
|
||||
|
||||
* tmpfiles.d(5) snippets may now use specifier expansion in
|
||||
|
||||
37
README
37
README
@ -37,8 +37,7 @@ LICENSE:
|
||||
- except src/udev/* which is (currently still) GPLv2, GPLv2+
|
||||
|
||||
REQUIREMENTS:
|
||||
Linux kernel >= 3.0
|
||||
Linux kernel >= 3.3 for loop device partition support features with nspawn
|
||||
Linux kernel >= 3.7
|
||||
Linux kernel >= 3.8 for Smack support
|
||||
|
||||
Kernel Config Options:
|
||||
@ -53,14 +52,14 @@ REQUIREMENTS:
|
||||
CONFIG_PROC_FS
|
||||
CONFIG_FHANDLE (libudev, mount and bind mount handling)
|
||||
|
||||
Udev will fail to work with the legacy layout:
|
||||
udev will fail to work with the legacy sysfs layout:
|
||||
CONFIG_SYSFS_DEPRECATED=n
|
||||
|
||||
Legacy hotplug slows down the system and confuses udev:
|
||||
CONFIG_UEVENT_HELPER_PATH=""
|
||||
|
||||
Userspace firmware loading is deprecated, will go away, and
|
||||
sometimes causes problems:
|
||||
Userspace firmware loading is not supported and should
|
||||
be disabled in the kernel:
|
||||
CONFIG_FW_LOADER_USER_HELPER=n
|
||||
|
||||
Some udev rules and virtualization detection relies on it:
|
||||
@ -117,10 +116,12 @@ REQUIREMENTS:
|
||||
libacl (optional)
|
||||
libselinux (optional)
|
||||
liblzma (optional)
|
||||
liblz4 >= 119 (optional)
|
||||
libgcrypt (optional)
|
||||
libqrencode (optional)
|
||||
libmicrohttpd (optional)
|
||||
libpython (optional)
|
||||
libidn (optional)
|
||||
gobject-introspection > 1.40.0 (optional)
|
||||
elfutils >= 158 (optional)
|
||||
make, gcc, and similar tools
|
||||
@ -128,11 +129,8 @@ REQUIREMENTS:
|
||||
During runtime, you need the following additional
|
||||
dependencies:
|
||||
|
||||
util-linux >= v2.19 (requires fsck -l, agetty -s),
|
||||
v2.21 required for tests in test/
|
||||
util-linux >= v2.25 required
|
||||
dbus >= 1.4.0 (strictly speaking optional, but recommended)
|
||||
sulogin (from util-linux >= 2.22 or sysvinit-tools, optional but recommended,
|
||||
required for tests in test/)
|
||||
dracut (optional)
|
||||
PolicyKit (optional)
|
||||
|
||||
@ -200,6 +198,27 @@ USERS AND GROUPS:
|
||||
Similarly, the kdbus dbus1 proxy daemon requires the
|
||||
"systemd-bus-proxy" system user and group to exist.
|
||||
|
||||
NSS:
|
||||
systemd ships with three NSS modules:
|
||||
|
||||
nss-myhostname resolves the local hostname to locally
|
||||
configured IP addresses, as well as "localhost" to
|
||||
127.0.0.1/::1.
|
||||
|
||||
nss-resolve enables DNS resolution via the systemd-resolved
|
||||
DNS/LLMNR caching stub resolver "systemd-resolved".
|
||||
|
||||
nss-mymachines enables resolution of all local containers
|
||||
registered with machined to their respective IP addresses.
|
||||
|
||||
To make use of these NSS modules, please add them to the
|
||||
"hosts: " line in /etc/nsswitch.conf. The "resolve" module
|
||||
should replace the glibc "dns" module in this file.
|
||||
|
||||
The three modules should be used in the following order:
|
||||
|
||||
hosts: files mymachines resolve myhostname
|
||||
|
||||
WARNINGS:
|
||||
systemd will warn you during boot if /etc/mtab is not a
|
||||
symlink to /proc/mounts. Please ensure that /etc/mtab is a
|
||||
|
||||
193
TODO
193
TODO
@ -1,6 +1,8 @@
|
||||
Fixes needed before 217:
|
||||
|
||||
* verify that both resolved and timesyncd work OK without networkd around
|
||||
|
||||
Bugfixes:
|
||||
* Re-enable "fsck -l" when it is ready:
|
||||
https://bugs.freedesktop.org/show_bug.cgi?id=79576#c5
|
||||
|
||||
* Should systemctl status \* work on all unit types, not just .service?
|
||||
|
||||
@ -10,63 +12,177 @@ Bugfixes:
|
||||
|
||||
* properly handle .mount unit state tracking when two mount points are stacked one on top of another on the exact same mount point.
|
||||
|
||||
External:
|
||||
* Fedora: when installing fedora with yum --installroot /var/run is a directory, not a symlink
|
||||
https://bugzilla.redhat.com/show_bug.cgi?id=975864
|
||||
* ExecStart with unicode characters fails in strv_split_quoted:
|
||||
|
||||
[Service]
|
||||
Environment=ONE='one' "TWO='two two' too" THREE=
|
||||
ExecStart=/bin/python3 -c 'import sys;print(sys.argv)' $ONE $TWO $THREE
|
||||
|
||||
* MEMORY return code is overloaded for syntax errors in the commandline.
|
||||
str_split_quoted() should return a real return code, so spawn_child can
|
||||
report the failure properly.
|
||||
|
||||
External:
|
||||
* Fedora: add an rpmlint check that verifies that all unit files in the RPM are listed in %systemd_post macros.
|
||||
|
||||
* Fedora: post FPC ticket to move add %tmpfiles_create to the packaging guidelines
|
||||
|
||||
* Fedora: move kernel image to /usr/lib/modules/, kernel-install will take care of populating /boot
|
||||
|
||||
* Fedora: remove /etc/resolv.conf tmpfiles hack
|
||||
|
||||
* wiki: update journal format documentation for lz4 additions
|
||||
|
||||
* When lz4 gets an API for lz4 command output, make use of it to
|
||||
compress coredumps in a way compatible with /usr/bin/lz4.
|
||||
|
||||
Features:
|
||||
|
||||
* new component "systemd-first-boot" which asks for locale, timezone,
|
||||
root password on first boot if the configuration for that has not
|
||||
been provisioned yet. Similar in style to what the distros have, but
|
||||
minimalist, text-only /dev/console stuff.
|
||||
* journald: allow per-priority and per-service retention times when rotating/vacuuming
|
||||
|
||||
* introduce systemd-timesync-wait.service or so to sync on an NTP fix?
|
||||
|
||||
* systemd --user should issue sd_notify() upon reaching basic.target, not on becoming idle
|
||||
|
||||
* configure.ac pretends dbus was optional but actually hardcodes use of dbus' pkg-config file to determine various dbus dirs such as policy and activation dirs
|
||||
|
||||
* consider showing the unit names during boot up in the status output, not just the unit descriptions
|
||||
|
||||
* dhcp: do we allow configuring dhcp routes on interfaces that are not the one we got the dhcp info from?
|
||||
|
||||
* maybe allow timer units with an empty Units= setting, so that they
|
||||
can be used for resuming the system but nothing else.
|
||||
|
||||
* what to do about udev db binary stability for apps?
|
||||
|
||||
* maybe provide an API to allow migration of foreign PIDs into existing scopes.
|
||||
|
||||
* kdbus: maybe rename "connection name" concept to something that doesn't reuse the word "name"?
|
||||
|
||||
* PID 1 doesn't apply nspawns devices cgroup policy
|
||||
|
||||
* rework journal-send.c to use memfds for large blobs if they are available instead of unlinked files in /tmp. Also, if we detect that the kernel knows memfds, refuse anything but sealed memfds.
|
||||
|
||||
* maybe support a new very "soft" reboot mode, that simply kills all processes, disassembles everything, flushes /run and sysvipc, and then reexecs systemd again
|
||||
|
||||
* man: document that corrupted journal files is nothing to act on
|
||||
|
||||
* bus-proxy: when passing messages from kdbus, make sure we properly
|
||||
handle the case where a large number of fds is appended that we
|
||||
cannot pass into sendmsg() of the AF_UNIX sokcet (which only accepts
|
||||
253 messages)
|
||||
|
||||
* busctl: add a pcap writer, using LINKTYPE_DBUS/231
|
||||
|
||||
* man: maybe use the word "inspect" rather than "introspect"?
|
||||
|
||||
* introduce machines.target to order after all nspawn instances
|
||||
|
||||
* systemd-nspawn@.service should fail if some nspawn arg is invalid, with Type=notify
|
||||
|
||||
* "machinectl list" should probably show columns for OS version and IP addresses
|
||||
|
||||
* systemctl: if it fails, show log output?
|
||||
|
||||
* maybe add "systemctl edit" that copies unit files from /usr/lib/systemd/system to /etc/systemd/system and invokes vim on them
|
||||
|
||||
* maybe introduce AssertXYZ= similar to ConditionXYZ= that causes a unit to fail (instead of skipping it) if some condition is not true...
|
||||
|
||||
* refcounting in sd-resolve is borked
|
||||
|
||||
* exponential backoff in timesyncd and resolved when we cannot reach a server
|
||||
|
||||
* journald: make use of uid-range.h to managed uid ranges to split
|
||||
journals in.
|
||||
|
||||
* tmpfiles: port to unquote_many_words(), similar to sysusers
|
||||
|
||||
* unquote_many_words() should probably be used by a lot of code that
|
||||
currently uses FOREACH_WORD and friends. For example, most conf
|
||||
parsing callbacks should use it.
|
||||
|
||||
* logind: make the Suspend()/Hibernate() bus calls wait for the for
|
||||
the job to be completed. before returning, so that clients can wait
|
||||
for "systemctl suspend" to finish to know when the suspending is
|
||||
complete.
|
||||
|
||||
* merge ~/.local/share and ~/.local/lib into one similar /usr/lib and /usr/share....
|
||||
|
||||
* journald: allows specification of UID range for splitting up journal files
|
||||
|
||||
* systemd.show_status= should probably have a mode where only failed
|
||||
units are shown.
|
||||
|
||||
* networkd:
|
||||
- add LLDP client side support
|
||||
- the DHCP lease data (such as NTP/DNS) is still made available when
|
||||
a carrier is lost on a link. It should be removed instantly.
|
||||
- .network setting that allows overriding of the hostname to send to the dhcp server
|
||||
http://lists.freedesktop.org/archives/systemd-devel/2014-July/021550.html
|
||||
- expose in the API the following bits:
|
||||
- option 15, domain name and/or option 119, search list
|
||||
- option 12, host name and/or option 81, fqdn
|
||||
- option 100, 101, timezone
|
||||
- option 123, 144, geolocation
|
||||
- option 252, configure http proxy (PAC/wpad)
|
||||
- networkd's dhcp server should transparently pass on the DNS and
|
||||
NTP server list it got from user configuration and its dhcp client
|
||||
to clients. It should also pass on its own timezone information.
|
||||
- provide a way to define a per-network interface default metric value
|
||||
for all routes to it. possibly a second default for DHCP routes.
|
||||
- allow Name= to be specified repeatedly in the [Match] section. Maybe also
|
||||
support Name=foo*|bar*|baz ?
|
||||
|
||||
* resolved:
|
||||
- put networkd events and rtnl events at a higher priority, so that
|
||||
we always process them before we process client requests
|
||||
- DNSSEC
|
||||
- use base64 for key presentation?
|
||||
- add display of private key types (http://tools.ietf.org/html/rfc4034#appendix-A.1.1)?
|
||||
- add nice formatting of DNS timestamps
|
||||
- DNS
|
||||
- search paths
|
||||
- mDNS/DNS-SD
|
||||
- avahi compat
|
||||
- DNS-SD service registration from socket units
|
||||
- edns0
|
||||
- dname
|
||||
- cname on PTR (?)
|
||||
|
||||
* Ignore .busname units on classic D-Bus boots, systemd-resolved cannot be started on kdbus
|
||||
without the active policy and should get a Wants=org.freedesktop.resolve1.busname to
|
||||
pull-in the policy.
|
||||
|
||||
* Allow multiple ExecStart= for all Type= settings, so that we can cover rescue.service nicely
|
||||
|
||||
* Add a new verb "systemctl top"
|
||||
|
||||
* order OnCalendar timer units after timer-sync.target if DefaultDependencies=no so that we don't trigger them prematurely
|
||||
|
||||
* refuse mounting on symlinks
|
||||
|
||||
* logind: allow users to kill or lock their own sessions
|
||||
|
||||
* add new gpt type for btrfs volumes
|
||||
|
||||
* support empty /etc boots nicely:
|
||||
- nspawn/gpt-generator: introduce new gpt partition type for /usr
|
||||
- nspawn: add --mode=auto,stateful,stateless,volatile
|
||||
- fstab-generator: support auot/stateful/stateless/volatile on the kernel cmdline, too
|
||||
- fstab-generator: support systemd.volatile=yes|no|state on the kernel cmdline, too, similar to nspawn's --volatile=
|
||||
- fstab-generator: add support for usr= in addition to root= on the kernel cmdline
|
||||
|
||||
* generator that automatically discovers btrfs subvolumes, identifies their purpose based on some xattr on them.
|
||||
|
||||
* support setting empty environment variables with Environment= and EnvironmentFile=
|
||||
|
||||
* machined/machinectl: sort IP addresses we return by scope and protocol
|
||||
* machined: write NSS module for looking up IP addresses for machines
|
||||
|
||||
* timer units: actually add extra delays to timer units with high AccuracySec values, don't start them already when we are awake...
|
||||
|
||||
* timesyncd - hookup with networkd: NTP servers from dhcp
|
||||
|
||||
* a way for container managers to turn off getty starting via $container_headless= or so...
|
||||
|
||||
* figure out a nice way how we can let the admin know what child/sibling unit causes cgroup membership for a specific unit
|
||||
|
||||
* journalctl: add the ability to look for the most recent process of a binary. journalctl /usr/bin/X11 --pid=-1 or so...
|
||||
|
||||
* set NOTIFY_SOCKET also for control processes
|
||||
|
||||
* mount_cgroup_controllers(): symlinks need to get the label applied
|
||||
|
||||
* For timer units: add some mechanisms so that timer units that trigger immediately on boot do not have the services
|
||||
they run added to the initial transaction and thus confuse Type=idle.
|
||||
|
||||
* Add timeout to early-boot, and shut down the system if it is hit. Solves the laptop-in-bag problem and is useful for embedded cases
|
||||
|
||||
* Run most system services with cgroupfs read-only and procfs with a more secure mode (doesn't work, since the hidepid= option is per-pid-namespace, not per-mount)
|
||||
|
||||
* sd-event: generate a failure of a default event loop is executed out-of-thread
|
||||
@ -146,8 +262,6 @@ Features:
|
||||
|
||||
* unify dispatch table in systemctl_main() and friends
|
||||
|
||||
* Automatically configure swap partition to use for hibernation by looking for largest swap partition on the root disk?
|
||||
|
||||
* rfkill,backlight: we probably should run the load tools inside of the udev rules so that the state is properly initialized by the time other software sees it
|
||||
|
||||
* After coming back from hibernation reset hibernation swap partition using the /dev/snapshot ioctl APIs
|
||||
@ -189,13 +303,13 @@ Features:
|
||||
- kdbus mapping
|
||||
- NameLost/NameAcquired obsolete
|
||||
- GVariant
|
||||
- "const" properties (posted)
|
||||
- path escaping
|
||||
- update systemd.special(7) to mention that dbus.socket is only about the compatibility socket now
|
||||
- test bloom filter generation indexes
|
||||
|
||||
* sd-event
|
||||
- allow multiple signal handlers per signal?
|
||||
- document chaining of signal handler for SIGCHLD and child handlers
|
||||
|
||||
* in the final killing spree, detect processes from the root directory, and
|
||||
complain loudly if they have argv[0][0] == '@' set.
|
||||
@ -212,8 +326,6 @@ Features:
|
||||
|
||||
* maybe add a generator that looks for "systemd.run=" on the kernel cmdline for container usercases...
|
||||
|
||||
* timedatctl, localectl: possibly make some commands work without the daemon, for chroot situations...
|
||||
|
||||
* timedatectl: print a nicer message when enabling ntp fails because ntpd/chrony are not installed
|
||||
|
||||
* cgtop: make cgtop useful in a container
|
||||
@ -376,7 +488,6 @@ Features:
|
||||
- "systemctl mask" should find all names by which a unit is accessible
|
||||
(i.e. by scanning for symlinks to it) and link them all to /dev/null
|
||||
- systemctl list-unit-files should list generated files (and probably with a new state "generated" for them, or so)
|
||||
- systemctl: maybe add "systemctl add-wants" or so...
|
||||
|
||||
* timer units:
|
||||
- timer units should get the ability to trigger when:
|
||||
@ -452,10 +563,6 @@ Features:
|
||||
|
||||
* properly handle loop back mounts via fstab, especially regards to fsck/passno
|
||||
|
||||
* allow services with no ExecStart= but with an ExecStop=
|
||||
|
||||
* dracut-shutdown needs to be ordered before unmounting /boot
|
||||
|
||||
* initialize the hostname from the fs label of /, if /etc/hostname does not exist?
|
||||
|
||||
* rename "userspace" to "core-os"
|
||||
@ -483,7 +590,6 @@ Features:
|
||||
* ExecOnFailure=/usr/bin/foo
|
||||
|
||||
* udev:
|
||||
- remove src/udev/udev-builtin-firmware.c (CONFIG_FW_LOADER_USER_HELPER=n)
|
||||
- move to LGPL
|
||||
- kill scsi_id
|
||||
- add trigger --subsystem-match=usb/usb_device device
|
||||
@ -529,9 +635,7 @@ Features:
|
||||
|
||||
* make sure systemd-ask-password-wall does not shutdown systemd-ask-password-console too early
|
||||
|
||||
* support sd_notify() style notification when reload begins (RELOADING=1), reload is finished (READY=1), and add ReloadSignal= then to use in combination
|
||||
|
||||
* support sd_notify() style notification when shutting down, to make auto-exit bus services work (STOPPING=1)
|
||||
* add ReloadSignal= for configuring a reload signal to use
|
||||
|
||||
* verify that the AF_UNIX sockets of a service in the fs still exist
|
||||
when we start a service in order to avoid confusion when a user
|
||||
@ -612,16 +716,13 @@ Features:
|
||||
* networkd:
|
||||
- add more keys to [Route] and [Address] sections
|
||||
- add support for more DHCPv4 options (and, longer term, other kinds of dynamic config)
|
||||
- send hostname to DHCP server
|
||||
- add proper initrd support (in particular generate .network/.link files based on /proc/cmdline)
|
||||
- add reduced [Link] support to .network files
|
||||
- add Scope= parsing option for [Network]
|
||||
- properly handle routerless dhcp leases
|
||||
- add veth netdev support (c.f. http://shorewall.net/bridge-Shorewall-perl.html#veth)
|
||||
- add tun/tap netdev support
|
||||
- add more attribute support for SIT tunnel
|
||||
- make metric of routes configurable
|
||||
- work with non-ethernet devices
|
||||
- add support for more bond options
|
||||
|
||||
* networkd-wait-online:
|
||||
- make operstates to wait for configurable?
|
||||
@ -629,7 +730,7 @@ Features:
|
||||
* dhcp:
|
||||
- figure out how much we can increase Maximum Message Size
|
||||
- export timezone information
|
||||
- FORCERENEW
|
||||
- support RFC4702 (pass FQDN)
|
||||
|
||||
* dhcp6:
|
||||
- add functions to set previously stored IPv6 addresses on startup and get
|
||||
@ -639,7 +740,6 @@ Features:
|
||||
- implement reconfigure support, see 5.3., 15.11. and 22.20.
|
||||
- implement information request, see 1.2. and 18.1.5.
|
||||
- implement support for temporary adressess (IA_TA)
|
||||
- implement elapsed time option
|
||||
- implement dhcpv6 authentication
|
||||
- investigate the usefulness of Confirm messages; i.e. are there any
|
||||
situations where the link changes without any loss in carrier detection
|
||||
@ -681,6 +781,11 @@ External:
|
||||
|
||||
* register catalog database signature as file magic
|
||||
|
||||
* zsh shell completion:
|
||||
- <command> <verb> -<TAB> should complete options, but currently does not
|
||||
- systemctl add-wants,add-requires
|
||||
|
||||
|
||||
Regularly:
|
||||
|
||||
* look for close() vs. close_nointr() vs. close_nointr_nofail()
|
||||
|
||||
311
build-aux/config.guess
vendored
311
build-aux/config.guess
vendored
@ -1,10 +1,8 @@
|
||||
#! /bin/sh
|
||||
# Attempt to guess a canonical system name.
|
||||
# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
|
||||
# 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
|
||||
# 2011, 2012, 2013 Free Software Foundation, Inc.
|
||||
# Copyright 1992-2014 Free Software Foundation, Inc.
|
||||
|
||||
timestamp='2012-12-29'
|
||||
timestamp='2014-03-23'
|
||||
|
||||
# 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
|
||||
@ -52,9 +50,7 @@ version="\
|
||||
GNU config.guess ($timestamp)
|
||||
|
||||
Originally written by Per Bothner.
|
||||
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
|
||||
2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
|
||||
2012, 2013 Free Software Foundation, Inc.
|
||||
Copyright 1992-2014 Free Software Foundation, Inc.
|
||||
|
||||
This is free software; see the source for copying conditions. There is NO
|
||||
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
|
||||
@ -136,6 +132,27 @@ UNAME_RELEASE=`(uname -r) 2>/dev/null` || UNAME_RELEASE=unknown
|
||||
UNAME_SYSTEM=`(uname -s) 2>/dev/null` || UNAME_SYSTEM=unknown
|
||||
UNAME_VERSION=`(uname -v) 2>/dev/null` || UNAME_VERSION=unknown
|
||||
|
||||
case "${UNAME_SYSTEM}" in
|
||||
Linux|GNU|GNU/*)
|
||||
# If the system lacks a compiler, then just pick glibc.
|
||||
# We could probably try harder.
|
||||
LIBC=gnu
|
||||
|
||||
eval $set_cc_for_build
|
||||
cat <<-EOF > $dummy.c
|
||||
#include <features.h>
|
||||
#if defined(__UCLIBC__)
|
||||
LIBC=uclibc
|
||||
#elif defined(__dietlibc__)
|
||||
LIBC=dietlibc
|
||||
#else
|
||||
LIBC=gnu
|
||||
#endif
|
||||
EOF
|
||||
eval `$CC_FOR_BUILD -E $dummy.c 2>/dev/null | grep '^LIBC' | sed 's, ,,g'`
|
||||
;;
|
||||
esac
|
||||
|
||||
# Note: order is significant - the case branches are not exclusive.
|
||||
|
||||
case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in
|
||||
@ -809,7 +826,7 @@ EOF
|
||||
*:MINGW*:*)
|
||||
echo ${UNAME_MACHINE}-pc-mingw32
|
||||
exit ;;
|
||||
i*:MSYS*:*)
|
||||
*:MSYS*:*)
|
||||
echo ${UNAME_MACHINE}-pc-msys
|
||||
exit ;;
|
||||
i*:windows32*:*)
|
||||
@ -857,21 +874,21 @@ EOF
|
||||
exit ;;
|
||||
*:GNU:*:*)
|
||||
# the GNU system
|
||||
echo `echo ${UNAME_MACHINE}|sed -e 's,[-/].*$,,'`-unknown-gnu`echo ${UNAME_RELEASE}|sed -e 's,/.*$,,'`
|
||||
echo `echo ${UNAME_MACHINE}|sed -e 's,[-/].*$,,'`-unknown-${LIBC}`echo ${UNAME_RELEASE}|sed -e 's,/.*$,,'`
|
||||
exit ;;
|
||||
*:GNU/*:*:*)
|
||||
# other systems with GNU libc and userland
|
||||
echo ${UNAME_MACHINE}-unknown-`echo ${UNAME_SYSTEM} | sed 's,^[^/]*/,,' | tr '[A-Z]' '[a-z]'``echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'`-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-`echo ${UNAME_SYSTEM} | sed 's,^[^/]*/,,' | tr '[A-Z]' '[a-z]'``echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'`-${LIBC}
|
||||
exit ;;
|
||||
i*86:Minix:*:*)
|
||||
echo ${UNAME_MACHINE}-pc-minix
|
||||
exit ;;
|
||||
aarch64:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
aarch64_be:Linux:*:*)
|
||||
UNAME_MACHINE=aarch64_be
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
alpha:Linux:*:*)
|
||||
case `sed -n '/^cpu model/s/^.*: \(.*\)/\1/p' < /proc/cpuinfo` in
|
||||
@ -884,59 +901,54 @@ EOF
|
||||
EV68*) UNAME_MACHINE=alphaev68 ;;
|
||||
esac
|
||||
objdump --private-headers /bin/sh | grep -q ld.so.1
|
||||
if test "$?" = 0 ; then LIBC="libc1" ; else LIBC="" ; fi
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu${LIBC}
|
||||
if test "$?" = 0 ; then LIBC="gnulibc1" ; fi
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
arc:Linux:*:* | arceb:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
arm*:Linux:*:*)
|
||||
eval $set_cc_for_build
|
||||
if echo __ARM_EABI__ | $CC_FOR_BUILD -E - 2>/dev/null \
|
||||
| grep -q __ARM_EABI__
|
||||
then
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
else
|
||||
if echo __ARM_PCS_VFP | $CC_FOR_BUILD -E - 2>/dev/null \
|
||||
| grep -q __ARM_PCS_VFP
|
||||
then
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnueabi
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}eabi
|
||||
else
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnueabihf
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}eabihf
|
||||
fi
|
||||
fi
|
||||
exit ;;
|
||||
avr32*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
cris:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-axis-linux-gnu
|
||||
echo ${UNAME_MACHINE}-axis-linux-${LIBC}
|
||||
exit ;;
|
||||
crisv32:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-axis-linux-gnu
|
||||
echo ${UNAME_MACHINE}-axis-linux-${LIBC}
|
||||
exit ;;
|
||||
frv:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
hexagon:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
i*86:Linux:*:*)
|
||||
LIBC=gnu
|
||||
eval $set_cc_for_build
|
||||
sed 's/^ //' << EOF >$dummy.c
|
||||
#ifdef __dietlibc__
|
||||
LIBC=dietlibc
|
||||
#endif
|
||||
EOF
|
||||
eval `$CC_FOR_BUILD -E $dummy.c 2>/dev/null | grep '^LIBC'`
|
||||
echo "${UNAME_MACHINE}-pc-linux-${LIBC}"
|
||||
echo ${UNAME_MACHINE}-pc-linux-${LIBC}
|
||||
exit ;;
|
||||
ia64:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
m32r*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
m68*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
mips:Linux:*:* | mips64:Linux:*:*)
|
||||
eval $set_cc_for_build
|
||||
@ -955,54 +967,63 @@ EOF
|
||||
#endif
|
||||
EOF
|
||||
eval `$CC_FOR_BUILD -E $dummy.c 2>/dev/null | grep '^CPU'`
|
||||
test x"${CPU}" != x && { echo "${CPU}-unknown-linux-gnu"; exit; }
|
||||
test x"${CPU}" != x && { echo "${CPU}-unknown-linux-${LIBC}"; exit; }
|
||||
;;
|
||||
or32:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
openrisc*:Linux:*:*)
|
||||
echo or1k-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
or32:Linux:*:* | or1k*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
padre:Linux:*:*)
|
||||
echo sparc-unknown-linux-gnu
|
||||
echo sparc-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
parisc64:Linux:*:* | hppa64:Linux:*:*)
|
||||
echo hppa64-unknown-linux-gnu
|
||||
echo hppa64-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
parisc:Linux:*:* | hppa:Linux:*:*)
|
||||
# Look for CPU level
|
||||
case `grep '^cpu[^a-z]*:' /proc/cpuinfo 2>/dev/null | cut -d' ' -f2` in
|
||||
PA7*) echo hppa1.1-unknown-linux-gnu ;;
|
||||
PA8*) echo hppa2.0-unknown-linux-gnu ;;
|
||||
*) echo hppa-unknown-linux-gnu ;;
|
||||
PA7*) echo hppa1.1-unknown-linux-${LIBC} ;;
|
||||
PA8*) echo hppa2.0-unknown-linux-${LIBC} ;;
|
||||
*) echo hppa-unknown-linux-${LIBC} ;;
|
||||
esac
|
||||
exit ;;
|
||||
ppc64:Linux:*:*)
|
||||
echo powerpc64-unknown-linux-gnu
|
||||
echo powerpc64-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
ppc:Linux:*:*)
|
||||
echo powerpc-unknown-linux-gnu
|
||||
echo powerpc-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
ppc64le:Linux:*:*)
|
||||
echo powerpc64le-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
ppcle:Linux:*:*)
|
||||
echo powerpcle-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
s390:Linux:*:* | s390x:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-ibm-linux
|
||||
echo ${UNAME_MACHINE}-ibm-linux-${LIBC}
|
||||
exit ;;
|
||||
sh64*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
sh*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
sparc:Linux:*:* | sparc64:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
tile*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
vax:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-dec-linux-gnu
|
||||
echo ${UNAME_MACHINE}-dec-linux-${LIBC}
|
||||
exit ;;
|
||||
x86_64:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
xtensa*:Linux:*:*)
|
||||
echo ${UNAME_MACHINE}-unknown-linux-gnu
|
||||
echo ${UNAME_MACHINE}-unknown-linux-${LIBC}
|
||||
exit ;;
|
||||
i*86:DYNIX/ptx:4*:*)
|
||||
# ptx 4.0 does uname -s correctly, with DYNIX/ptx in there.
|
||||
@ -1235,19 +1256,31 @@ EOF
|
||||
exit ;;
|
||||
*:Darwin:*:*)
|
||||
UNAME_PROCESSOR=`uname -p` || UNAME_PROCESSOR=unknown
|
||||
case $UNAME_PROCESSOR in
|
||||
i386)
|
||||
eval $set_cc_for_build
|
||||
if [ "$CC_FOR_BUILD" != 'no_compiler_found' ]; then
|
||||
if (echo '#ifdef __LP64__'; echo IS_64BIT_ARCH; echo '#endif') | \
|
||||
(CCOPTS= $CC_FOR_BUILD -E - 2>/dev/null) | \
|
||||
grep IS_64BIT_ARCH >/dev/null
|
||||
then
|
||||
UNAME_PROCESSOR="x86_64"
|
||||
fi
|
||||
fi ;;
|
||||
unknown) UNAME_PROCESSOR=powerpc ;;
|
||||
esac
|
||||
eval $set_cc_for_build
|
||||
if test "$UNAME_PROCESSOR" = unknown ; then
|
||||
UNAME_PROCESSOR=powerpc
|
||||
fi
|
||||
if test `echo "$UNAME_RELEASE" | sed -e 's/\..*//'` -le 10 ; then
|
||||
if [ "$CC_FOR_BUILD" != 'no_compiler_found' ]; then
|
||||
if (echo '#ifdef __LP64__'; echo IS_64BIT_ARCH; echo '#endif') | \
|
||||
(CCOPTS= $CC_FOR_BUILD -E - 2>/dev/null) | \
|
||||
grep IS_64BIT_ARCH >/dev/null
|
||||
then
|
||||
case $UNAME_PROCESSOR in
|
||||
i386) UNAME_PROCESSOR=x86_64 ;;
|
||||
powerpc) UNAME_PROCESSOR=powerpc64 ;;
|
||||
esac
|
||||
fi
|
||||
fi
|
||||
elif test "$UNAME_PROCESSOR" = i386 ; then
|
||||
# Avoid executing cc on OS X 10.9, as it ships with a stub
|
||||
# that puts up a graphical alert prompting to install
|
||||
# developer tools. Any system running Mac OS X 10.7 or
|
||||
# later (Darwin 11 and later) is required to have a 64-bit
|
||||
# processor. This is not true of the ARM version of Darwin
|
||||
# that Apple uses in portable devices.
|
||||
UNAME_PROCESSOR=x86_64
|
||||
fi
|
||||
echo ${UNAME_PROCESSOR}-apple-darwin${UNAME_RELEASE}
|
||||
exit ;;
|
||||
*:procnto*:*:* | *:QNX:[0123456789]*:*)
|
||||
@ -1338,154 +1371,6 @@ EOF
|
||||
exit ;;
|
||||
esac
|
||||
|
||||
eval $set_cc_for_build
|
||||
cat >$dummy.c <<EOF
|
||||
#ifdef _SEQUENT_
|
||||
# include <sys/types.h>
|
||||
# include <sys/utsname.h>
|
||||
#endif
|
||||
main ()
|
||||
{
|
||||
#if defined (sony)
|
||||
#if defined (MIPSEB)
|
||||
/* BFD wants "bsd" instead of "newsos". Perhaps BFD should be changed,
|
||||
I don't know.... */
|
||||
printf ("mips-sony-bsd\n"); exit (0);
|
||||
#else
|
||||
#include <sys/param.h>
|
||||
printf ("m68k-sony-newsos%s\n",
|
||||
#ifdef NEWSOS4
|
||||
"4"
|
||||
#else
|
||||
""
|
||||
#endif
|
||||
); exit (0);
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if defined (__arm) && defined (__acorn) && defined (__unix)
|
||||
printf ("arm-acorn-riscix\n"); exit (0);
|
||||
#endif
|
||||
|
||||
#if defined (hp300) && !defined (hpux)
|
||||
printf ("m68k-hp-bsd\n"); exit (0);
|
||||
#endif
|
||||
|
||||
#if defined (NeXT)
|
||||
#if !defined (__ARCHITECTURE__)
|
||||
#define __ARCHITECTURE__ "m68k"
|
||||
#endif
|
||||
int version;
|
||||
version=`(hostinfo | sed -n 's/.*NeXT Mach \([0-9]*\).*/\1/p') 2>/dev/null`;
|
||||
if (version < 4)
|
||||
printf ("%s-next-nextstep%d\n", __ARCHITECTURE__, version);
|
||||
else
|
||||
printf ("%s-next-openstep%d\n", __ARCHITECTURE__, version);
|
||||
exit (0);
|
||||
#endif
|
||||
|
||||
#if defined (MULTIMAX) || defined (n16)
|
||||
#if defined (UMAXV)
|
||||
printf ("ns32k-encore-sysv\n"); exit (0);
|
||||
#else
|
||||
#if defined (CMU)
|
||||
printf ("ns32k-encore-mach\n"); exit (0);
|
||||
#else
|
||||
printf ("ns32k-encore-bsd\n"); exit (0);
|
||||
#endif
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if defined (__386BSD__)
|
||||
printf ("i386-pc-bsd\n"); exit (0);
|
||||
#endif
|
||||
|
||||
#if defined (sequent)
|
||||
#if defined (i386)
|
||||
printf ("i386-sequent-dynix\n"); exit (0);
|
||||
#endif
|
||||
#if defined (ns32000)
|
||||
printf ("ns32k-sequent-dynix\n"); exit (0);
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if defined (_SEQUENT_)
|
||||
struct utsname un;
|
||||
|
||||
uname(&un);
|
||||
|
||||
if (strncmp(un.version, "V2", 2) == 0) {
|
||||
printf ("i386-sequent-ptx2\n"); exit (0);
|
||||
}
|
||||
if (strncmp(un.version, "V1", 2) == 0) { /* XXX is V1 correct? */
|
||||
printf ("i386-sequent-ptx1\n"); exit (0);
|
||||
}
|
||||
printf ("i386-sequent-ptx\n"); exit (0);
|
||||
|
||||
#endif
|
||||
|
||||
#if defined (vax)
|
||||
# if !defined (ultrix)
|
||||
# include <sys/param.h>
|
||||
# if defined (BSD)
|
||||
# if BSD == 43
|
||||
printf ("vax-dec-bsd4.3\n"); exit (0);
|
||||
# else
|
||||
# if BSD == 199006
|
||||
printf ("vax-dec-bsd4.3reno\n"); exit (0);
|
||||
# else
|
||||
printf ("vax-dec-bsd\n"); exit (0);
|
||||
# endif
|
||||
# endif
|
||||
# else
|
||||
printf ("vax-dec-bsd\n"); exit (0);
|
||||
# endif
|
||||
# else
|
||||
printf ("vax-dec-ultrix\n"); exit (0);
|
||||
# endif
|
||||
#endif
|
||||
|
||||
#if defined (alliant) && defined (i860)
|
||||
printf ("i860-alliant-bsd\n"); exit (0);
|
||||
#endif
|
||||
|
||||
exit (1);
|
||||
}
|
||||
EOF
|
||||
|
||||
$CC_FOR_BUILD -o $dummy $dummy.c 2>/dev/null && SYSTEM_NAME=`$dummy` &&
|
||||
{ echo "$SYSTEM_NAME"; exit; }
|
||||
|
||||
# Apollos put the system type in the environment.
|
||||
|
||||
test -d /usr/apollo && { echo ${ISP}-apollo-${SYSTYPE}; exit; }
|
||||
|
||||
# Convex versions that predate uname can use getsysinfo(1)
|
||||
|
||||
if [ -x /usr/convex/getsysinfo ]
|
||||
then
|
||||
case `getsysinfo -f cpu_type` in
|
||||
c1*)
|
||||
echo c1-convex-bsd
|
||||
exit ;;
|
||||
c2*)
|
||||
if getsysinfo -f scalar_acc
|
||||
then echo c32-convex-bsd
|
||||
else echo c2-convex-bsd
|
||||
fi
|
||||
exit ;;
|
||||
c34*)
|
||||
echo c34-convex-bsd
|
||||
exit ;;
|
||||
c38*)
|
||||
echo c38-convex-bsd
|
||||
exit ;;
|
||||
c4*)
|
||||
echo c4-convex-bsd
|
||||
exit ;;
|
||||
esac
|
||||
fi
|
||||
|
||||
cat >&2 <<EOF
|
||||
$0: unable to guess system type
|
||||
|
||||
|
||||
56
build-aux/config.sub
vendored
56
build-aux/config.sub
vendored
@ -1,10 +1,8 @@
|
||||
#! /bin/sh
|
||||
# Configuration validation subroutine script.
|
||||
# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
|
||||
# 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
|
||||
# 2011, 2012, 2013 Free Software Foundation, Inc.
|
||||
# Copyright 1992-2014 Free Software Foundation, Inc.
|
||||
|
||||
timestamp='2012-12-29'
|
||||
timestamp='2014-07-28'
|
||||
|
||||
# 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
|
||||
@ -70,9 +68,7 @@ Report bugs and patches to <config-patches@gnu.org>."
|
||||
version="\
|
||||
GNU config.sub ($timestamp)
|
||||
|
||||
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
|
||||
2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
|
||||
2012, 2013 Free Software Foundation, Inc.
|
||||
Copyright 1992-2014 Free Software Foundation, Inc.
|
||||
|
||||
This is free software; see the source for copying conditions. There is NO
|
||||
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
|
||||
@ -256,12 +252,12 @@ case $basic_machine in
|
||||
| alpha | alphaev[4-8] | alphaev56 | alphaev6[78] | alphapca5[67] \
|
||||
| alpha64 | alpha64ev[4-8] | alpha64ev56 | alpha64ev6[78] | alpha64pca5[67] \
|
||||
| am33_2.0 \
|
||||
| arc \
|
||||
| arc | arceb \
|
||||
| arm | arm[bl]e | arme[lb] | armv[2-8] | armv[3-8][lb] | armv7[arm] \
|
||||
| avr | avr32 \
|
||||
| be32 | be64 \
|
||||
| bfin \
|
||||
| c4x | clipper \
|
||||
| c4x | c8051 | clipper \
|
||||
| d10v | d30v | dlx | dsp16xx \
|
||||
| epiphany \
|
||||
| fido | fr30 | frv \
|
||||
@ -269,6 +265,7 @@ case $basic_machine in
|
||||
| hexagon \
|
||||
| i370 | i860 | i960 | ia64 \
|
||||
| ip2k | iq2000 \
|
||||
| k1om \
|
||||
| le32 | le64 \
|
||||
| lm32 \
|
||||
| m32c | m32r | m32rle | m68000 | m68k | m88k \
|
||||
@ -286,20 +283,22 @@ case $basic_machine in
|
||||
| mips64vr5900 | mips64vr5900el \
|
||||
| mipsisa32 | mipsisa32el \
|
||||
| mipsisa32r2 | mipsisa32r2el \
|
||||
| mipsisa32r6 | mipsisa32r6el \
|
||||
| mipsisa64 | mipsisa64el \
|
||||
| mipsisa64r2 | mipsisa64r2el \
|
||||
| mipsisa64r6 | mipsisa64r6el \
|
||||
| mipsisa64sb1 | mipsisa64sb1el \
|
||||
| mipsisa64sr71k | mipsisa64sr71kel \
|
||||
| mipsr5900 | mipsr5900el \
|
||||
| mipstx39 | mipstx39el \
|
||||
| mn10200 | mn10300 \
|
||||
| moxie \
|
||||
| mt \
|
||||
| msp430 \
|
||||
| nds32 | nds32le | nds32be \
|
||||
| nios | nios2 \
|
||||
| nios | nios2 | nios2eb | nios2el \
|
||||
| ns16k | ns32k \
|
||||
| open8 \
|
||||
| or32 \
|
||||
| open8 | or1k | or1knd | or32 \
|
||||
| pdp10 | pdp11 | pj | pjl \
|
||||
| powerpc | powerpc64 | powerpc64le | powerpcle \
|
||||
| pyramid \
|
||||
@ -327,7 +326,7 @@ case $basic_machine in
|
||||
c6x)
|
||||
basic_machine=tic6x-unknown
|
||||
;;
|
||||
m6811 | m68hc11 | m6812 | m68hc12 | m68hcs12x | picochip)
|
||||
m6811 | m68hc11 | m6812 | m68hc12 | m68hcs12x | nvptx | picochip)
|
||||
basic_machine=$basic_machine-unknown
|
||||
os=-none
|
||||
;;
|
||||
@ -369,13 +368,13 @@ case $basic_machine in
|
||||
| aarch64-* | aarch64_be-* \
|
||||
| alpha-* | alphaev[4-8]-* | alphaev56-* | alphaev6[78]-* \
|
||||
| alpha64-* | alpha64ev[4-8]-* | alpha64ev56-* | alpha64ev6[78]-* \
|
||||
| alphapca5[67]-* | alpha64pca5[67]-* | arc-* \
|
||||
| alphapca5[67]-* | alpha64pca5[67]-* | arc-* | arceb-* \
|
||||
| arm-* | armbe-* | armle-* | armeb-* | armv*-* \
|
||||
| avr-* | avr32-* \
|
||||
| be32-* | be64-* \
|
||||
| bfin-* | bs2000-* \
|
||||
| c[123]* | c30-* | [cjt]90-* | c4x-* \
|
||||
| clipper-* | craynv-* | cydra-* \
|
||||
| c8051-* | clipper-* | craynv-* | cydra-* \
|
||||
| d10v-* | d30v-* | dlx-* \
|
||||
| elxsi-* \
|
||||
| f30[01]-* | f700-* | fido-* | fr30-* | frv-* | fx80-* \
|
||||
@ -384,6 +383,7 @@ case $basic_machine in
|
||||
| hexagon-* \
|
||||
| i*86-* | i860-* | i960-* | ia64-* \
|
||||
| ip2k-* | iq2000-* \
|
||||
| k1om-* \
|
||||
| le32-* | le64-* \
|
||||
| lm32-* \
|
||||
| m32c-* | m32r-* | m32rle-* \
|
||||
@ -403,18 +403,22 @@ case $basic_machine in
|
||||
| mips64vr5900-* | mips64vr5900el-* \
|
||||
| mipsisa32-* | mipsisa32el-* \
|
||||
| mipsisa32r2-* | mipsisa32r2el-* \
|
||||
| mipsisa32r6-* | mipsisa32r6el-* \
|
||||
| mipsisa64-* | mipsisa64el-* \
|
||||
| mipsisa64r2-* | mipsisa64r2el-* \
|
||||
| mipsisa64r6-* | mipsisa64r6el-* \
|
||||
| mipsisa64sb1-* | mipsisa64sb1el-* \
|
||||
| mipsisa64sr71k-* | mipsisa64sr71kel-* \
|
||||
| mipsr5900-* | mipsr5900el-* \
|
||||
| mipstx39-* | mipstx39el-* \
|
||||
| mmix-* \
|
||||
| mt-* \
|
||||
| msp430-* \
|
||||
| nds32-* | nds32le-* | nds32be-* \
|
||||
| nios-* | nios2-* \
|
||||
| nios-* | nios2-* | nios2eb-* | nios2el-* \
|
||||
| none-* | np1-* | ns16k-* | ns32k-* \
|
||||
| open8-* \
|
||||
| or1k*-* \
|
||||
| orion-* \
|
||||
| pdp10-* | pdp11-* | pj-* | pjl-* | pn-* | power-* \
|
||||
| powerpc-* | powerpc64-* | powerpc64le-* | powerpcle-* \
|
||||
@ -796,7 +800,7 @@ case $basic_machine in
|
||||
os=-mingw64
|
||||
;;
|
||||
mingw32)
|
||||
basic_machine=i386-pc
|
||||
basic_machine=i686-pc
|
||||
os=-mingw32
|
||||
;;
|
||||
mingw32ce)
|
||||
@ -824,6 +828,10 @@ case $basic_machine in
|
||||
basic_machine=powerpc-unknown
|
||||
os=-morphos
|
||||
;;
|
||||
moxiebox)
|
||||
basic_machine=moxie-unknown
|
||||
os=-moxiebox
|
||||
;;
|
||||
msdos)
|
||||
basic_machine=i386-pc
|
||||
os=-msdos
|
||||
@ -832,7 +840,7 @@ case $basic_machine in
|
||||
basic_machine=`echo $basic_machine | sed -e 's/ms1-/mt-/'`
|
||||
;;
|
||||
msys)
|
||||
basic_machine=i386-pc
|
||||
basic_machine=i686-pc
|
||||
os=-msys
|
||||
;;
|
||||
mvs)
|
||||
@ -1354,7 +1362,7 @@ case $os in
|
||||
-gnu* | -bsd* | -mach* | -minix* | -genix* | -ultrix* | -irix* \
|
||||
| -*vms* | -sco* | -esix* | -isc* | -aix* | -cnk* | -sunos | -sunos[34]*\
|
||||
| -hpux* | -unos* | -osf* | -luna* | -dgux* | -auroraux* | -solaris* \
|
||||
| -sym* | -kopensolaris* \
|
||||
| -sym* | -kopensolaris* | -plan9* \
|
||||
| -amigaos* | -amigados* | -msdos* | -newsos* | -unicos* | -aof* \
|
||||
| -aos* | -aros* \
|
||||
| -nindy* | -vxsim* | -vxworks* | -ebmon* | -hms* | -mvs* \
|
||||
@ -1369,14 +1377,14 @@ case $os in
|
||||
| -cygwin* | -msys* | -pe* | -psos* | -moss* | -proelf* | -rtems* \
|
||||
| -mingw32* | -mingw64* | -linux-gnu* | -linux-android* \
|
||||
| -linux-newlib* | -linux-musl* | -linux-uclibc* \
|
||||
| -uxpv* | -beos* | -mpeix* | -udk* \
|
||||
| -uxpv* | -beos* | -mpeix* | -udk* | -moxiebox* \
|
||||
| -interix* | -uwin* | -mks* | -rhapsody* | -darwin* | -opened* \
|
||||
| -openstep* | -oskit* | -conix* | -pw32* | -nonstopux* \
|
||||
| -storm-chaos* | -tops10* | -tenex* | -tops20* | -its* \
|
||||
| -os2* | -vos* | -palmos* | -uclinux* | -nucleus* \
|
||||
| -morphos* | -superux* | -rtmk* | -rtmk-nova* | -windiss* \
|
||||
| -powermax* | -dnix* | -nx6 | -nx7 | -sei* | -dragonfly* \
|
||||
| -skyos* | -haiku* | -rdos* | -toppers* | -drops* | -es*)
|
||||
| -skyos* | -haiku* | -rdos* | -toppers* | -drops* | -es* | -tirtos*)
|
||||
# Remember, each alternative MUST END IN *, to match a version number.
|
||||
;;
|
||||
-qnx*)
|
||||
@ -1500,9 +1508,6 @@ case $os in
|
||||
-aros*)
|
||||
os=-aros
|
||||
;;
|
||||
-kaos*)
|
||||
os=-kaos
|
||||
;;
|
||||
-zvmoe)
|
||||
os=-zvmoe
|
||||
;;
|
||||
@ -1551,6 +1556,9 @@ case $basic_machine in
|
||||
c4x-* | tic4x-*)
|
||||
os=-coff
|
||||
;;
|
||||
c8051-*)
|
||||
os=-elf
|
||||
;;
|
||||
hexagon-*)
|
||||
os=-elf
|
||||
;;
|
||||
|
||||
261
catalog/systemd.pl.catalog
Normal file
261
catalog/systemd.pl.catalog
Normal file
@ -0,0 +1,261 @@
|
||||
# This file is part of systemd.
|
||||
#
|
||||
# Copyright 2012 Lennart Poettering
|
||||
# Copyright 2014 Piotr Drąg
|
||||
#
|
||||
# systemd is free software; you can redistribute it and/or modify it
|
||||
# under the terms of the GNU Lesser General Public License as published by
|
||||
# the Free Software Foundation; either version 2.1 of the License, or
|
||||
# (at your option) any later version.
|
||||
#
|
||||
# systemd 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
|
||||
# Lesser General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU Lesser General Public License
|
||||
# along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
# Message catalog for systemd's own messages
|
||||
# Polish translation
|
||||
|
||||
# The catalog format is documented on
|
||||
# http://www.freedesktop.org/wiki/Software/systemd/catalog
|
||||
|
||||
# For an explanation why we do all this, see https://xkcd.com/1024/
|
||||
|
||||
-- f77379a8490b408bbe5f6940505a777b
|
||||
Subject: Uruchomiono Journal
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Systemowy proces dziennika został uruchomiony, otworzył pliki dziennika do
|
||||
zapisu i jest gotowy do przetwarzania żądań.
|
||||
|
||||
-- d93fb3c9c24d451a97cea615ce59c00b
|
||||
Subject: Zatrzymano Journal
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Systemowy proces dziennika został wyłączony i zamknął wszystkie obecnie
|
||||
aktywne pliki dziennika.
|
||||
|
||||
-- a596d6fe7bfa4994828e72309e95d61e
|
||||
Subject: Ograniczono komunikaty z usługi
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
Documentation: man:journald.conf(5)
|
||||
|
||||
Usługa zapisała za dużo komunikatów w określonym czasie. Komunikaty z usługi
|
||||
zostały pominięte.
|
||||
|
||||
Proszę zauważyć, że tylko komunikaty z danej usługi zostały pominięte. Nie ma
|
||||
to wpływu na komunikaty innych usług.
|
||||
|
||||
Ograniczenia komunikatów mogą być konfigurowane za pomocą opcji
|
||||
RateLimitInterval= i RateLimitBurst= w pliku
|
||||
/etc/systemd/journald.conf. Strona journald.conf(5) zawiera więcej informacji.
|
||||
|
||||
-- e9bf28e6e834481bb6f48f548ad13606
|
||||
Subject: Utracono komunikaty Journal
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Komunikaty jądra zostały utracone, ponieważ system dziennika nie mógł
|
||||
przetworzyć ich odpowiednio szybko.
|
||||
|
||||
-- fc2e22bc6ee647b6b90729ab34a250b1
|
||||
Subject: Proces @COREDUMP_PID@ (@COREDUMP_COMM@) zrzucił plik core
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
Documentation: man:core(5)
|
||||
|
||||
Proces @COREDUMP_PID@ (@COREDUMP_COMM@) uległ awarii i zrzucił plik core.
|
||||
|
||||
Zwykle wskazuje to na błąd programistyczny w danym programie i powinno zostać zgłoszone jego producentowi jako błąd.
|
||||
|
||||
-- 8d45620c1a4348dbb17410da57c60c66
|
||||
Subject: Utworzono nową sesję @SESSION_ID@ dla użytkownika @USER_ID@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
Documentation: http://www.freedesktop.org/wiki/Software/systemd/multiseat
|
||||
|
||||
Nowa sesja o identyfikatorze @SESSION_ID@ została utworzona dla użytkownika
|
||||
@USER_ID@.
|
||||
|
||||
Proces prowadzący sesji: @LEADER@.
|
||||
|
||||
-- 3354939424b4456d9802ca8333ed424a
|
||||
Subject: Zakończono sesję @SESSION_ID@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
Documentation: http://www.freedesktop.org/wiki/Software/systemd/multiseat
|
||||
|
||||
Sesja o identyfikatorze @SESSION_ID@ została zakończona.
|
||||
|
||||
-- fcbefc5da23d428093f97c82a9290f7b
|
||||
Subject: Dostępne jest nowe stanowisko @SEAT_ID@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
Documentation: http://www.freedesktop.org/wiki/Software/systemd/multiseat
|
||||
|
||||
Nowe stanowisko @SEAT_ID@ zostało skonfigurowane i jest teraz dostępne.
|
||||
|
||||
-- e7852bfe46784ed0accde04bc864c2d5
|
||||
Subject: Usunięto stanowisko @SEAT_ID@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
Documentation: http://www.freedesktop.org/wiki/Software/systemd/multiseat
|
||||
|
||||
Stanowisko @SEAT_ID@ zostało usunięte i nie jest już dostępne.
|
||||
|
||||
-- c7a787079b354eaaa9e77b371893cd27
|
||||
Subject: Zmiana czasu
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Zegar systemowy został zmieniony na @REALTIME@ μs po 1 stycznia 1970.
|
||||
|
||||
-- 45f82f4aef7a4bbf942ce861d1f20990
|
||||
Subject: Zmiana strefy czasowej na @TIMEZONE@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Systemowa strefa czasowa została zmieniona na @TIMEZONE@.
|
||||
|
||||
-- b07a249cd024414a82dd00cd181378ff
|
||||
Subject: Ukończono uruchamianie systemu
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Wszystkie usługi systemowe obowiązkowo zakolejkowane do włączenia podczas
|
||||
uruchamiania systemu zostały pomyślnie uruchomione. Proszę zauważyć, że nie
|
||||
oznacza to, że komputer jest bezczynny, jako że usługi mogą wciąż kończyć
|
||||
proces uruchamiania.
|
||||
|
||||
Uruchamianie jądra zajęło @KERNEL_USEC@ μs.
|
||||
|
||||
Uruchamianie początkowego dysku RAM zajęło @INITRD_USEC@ μs.
|
||||
|
||||
Uruchamianie przestrzeni użytkownika zajęło @USERSPACE_USEC@ μs.
|
||||
|
||||
-- 6bbd95ee977941e497c48be27c254128
|
||||
Subject: Przejście do stanu uśpienia @SLEEP@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
System przeszedł do stanu uśpienia @SLEEP@.
|
||||
|
||||
-- 8811e6df2a8e40f58a94cea26f8ebf14
|
||||
Subject: Wyjście ze stanu uśpienia @SLEEP@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
System wyszedł ze stanu uśpienia @SLEEP@.
|
||||
|
||||
-- 98268866d1d54a499c4e98921d93bc40
|
||||
Subject: Zainicjowano wyłączenie systemu
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Zainicjowano wyłączenie systemd. Wyłączenie zostało rozpoczęte i wszystkie
|
||||
usługi systemowe zostały zakończone, a wszystkie systemy plików odmontowane.
|
||||
|
||||
-- 7d4958e842da4a758f6c1cdc7b36dcc5
|
||||
Subject: Rozpoczęto uruchamianie jednostki @UNIT@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ rozpoczęła uruchamianie.
|
||||
|
||||
-- 39f53479d3a045ac8e11786248231fbf
|
||||
Subject: Ukończono uruchamianie jednostki @UNIT@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ ukończyła uruchamianie.
|
||||
|
||||
Wynik uruchamiania: @RESULT@.
|
||||
|
||||
-- de5b426a63be47a7b6ac3eaac82e2f6f
|
||||
Subject: Rozpoczęto wyłączanie jednostki @UNIT@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ rozpoczęła wyłączanie.
|
||||
|
||||
-- 9d1aaa27d60140bd96365438aad20286
|
||||
Subject: Ukończono wyłączanie jednostki @UNIT@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ ukończyła wyłączanie.
|
||||
|
||||
-- be02cf6855d2428ba40df7e9d022f03d
|
||||
Subject: Jednostka @UNIT@ się nie powiodła
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ się nie powiodła.
|
||||
|
||||
Wynik: @RESULT@.
|
||||
|
||||
-- d34d037fff1847e6ae669a370e694725
|
||||
Subject: Rozpoczęto ponowne wczytywanie konfiguracji jednostki @UNIT@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ rozpoczęła ponowne wczytywanie swojej konfiguracji.
|
||||
|
||||
-- 7b05ebc668384222baa8881179cfda54
|
||||
Subject: Ukończono ponowne wczytywanie konfiguracji jednostki @UNIT@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jednostka @UNIT@ ukończyła ponowne wczytywanie swojej konfiguracji.
|
||||
|
||||
Wynik: @RESULT@.
|
||||
|
||||
-- 641257651c1b4ec9a8624d7a40a9e1e7
|
||||
Subject: Nie można wykonać procesu @EXECUTABLE@
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Proces @EXECUTABLE@ nie mógł zostać wykonany i się nie powiódł.
|
||||
|
||||
Numer błędu zwrócony podczas wykonywania tego procesu: @ERRNO@.
|
||||
|
||||
-- 0027229ca0644181a76c4e92458afa2e
|
||||
Subject: Nie można przekazać jednego lub więcej komunikatów do syslog
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Jeden lub więcej komunikatów nie może zostać przekazanych do usługi syslog
|
||||
uruchomionej obok journald. Zwykle oznacza to, że implementacja syslog nie
|
||||
jest w stanie nadążyć za prędkością kolejki komunikatów.
|
||||
|
||||
-- 1dee0369c7fc4736b7099b38ecb46ee7
|
||||
Subject: Punkt montowania nie jest pusty
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Katalog @WHERE@ został podany jako punkt montowania (drugie pole w pliku
|
||||
/etc/fstab lub pole Where= w pliku jednostki systemd) i nie jest pusty. Nie
|
||||
wpływa to na montowanie, ale wcześniej istniejące pliki w tym katalogu stają
|
||||
się niedostępne. Aby zobaczyć te pliki, proszę ręcznie zamontować system
|
||||
plików w innym położeniu.
|
||||
|
||||
-- 24d8d4452573402496068381a6312df2
|
||||
Subject: Uruchomiono maszynę wirtualną lub kontener
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Maszyna wirtualna @NAME@ (PID prowadzący @LEADER@) została uruchomiona i jest
|
||||
gotowa do użycia.
|
||||
|
||||
-- 58432bd3bace477cb514b56381b8a758
|
||||
Subject: Zakończono maszynę wirtualną lub kontener
|
||||
Defined-By: systemd
|
||||
Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel
|
||||
|
||||
Maszyna wirtualna @NAME@ (PID prowadzący @LEADER@) została wyłączona.
|
||||
44
config.h.in
44
config.h.in
@ -21,6 +21,9 @@
|
||||
/* Define if PolicyKit support is to be enabled */
|
||||
#undef ENABLE_POLKIT
|
||||
|
||||
/* Define if terminal support is to be enabled */
|
||||
#undef ENABLE_TERMINAL
|
||||
|
||||
/* ACL available */
|
||||
#undef HAVE_ACL
|
||||
|
||||
@ -61,6 +64,10 @@
|
||||
`IFLA_IPTUN_6RD_RELAY_PREFIXLEN', and to 0 if you don't. */
|
||||
#undef HAVE_DECL_IFLA_IPTUN_6RD_RELAY_PREFIXLEN
|
||||
|
||||
/* Define to 1 if you have the declaration of `IFLA_MACVLAN_FLAGS', and to 0
|
||||
if you don't. */
|
||||
#undef HAVE_DECL_IFLA_MACVLAN_FLAGS
|
||||
|
||||
/* Define to 1 if you have the declaration of `IFLA_PHYS_PORT_ID', and to 0 if
|
||||
you don't. */
|
||||
#undef HAVE_DECL_IFLA_PHYS_PORT_ID
|
||||
@ -69,6 +76,10 @@
|
||||
if you don't. */
|
||||
#undef HAVE_DECL_IFLA_VLAN_PROTOCOL
|
||||
|
||||
/* Define to 1 if you have the declaration of `IFLA_VTI_REMOTE', and to 0 if
|
||||
you don't. */
|
||||
#undef HAVE_DECL_IFLA_VTI_REMOTE
|
||||
|
||||
/* Define to 1 if you have the declaration of `IFLA_VXLAN_LOCAL6', and to 0 if
|
||||
you don't. */
|
||||
#undef HAVE_DECL_IFLA_VXLAN_LOCAL6
|
||||
@ -98,18 +109,9 @@
|
||||
/* Define to 1 if you have the <elfutils/libdwfl.h> header file. */
|
||||
#undef HAVE_ELFUTILS_LIBDWFL_H
|
||||
|
||||
/* Define to 1 if you have the `fanotify_init' function. */
|
||||
#undef HAVE_FANOTIFY_INIT
|
||||
|
||||
/* Define to 1 if you have the `fanotify_mark' function. */
|
||||
#undef HAVE_FANOTIFY_MARK
|
||||
|
||||
/* Define to 1 if you have the <fcntl.h> header file. */
|
||||
#undef HAVE_FCNTL_H
|
||||
|
||||
/* Define if FIRMWARE is available */
|
||||
#undef HAVE_FIRMWARE
|
||||
|
||||
/* GCRYPT available */
|
||||
#undef HAVE_GCRYPT
|
||||
|
||||
@ -146,15 +148,30 @@
|
||||
/* Define if libcryptsetup is available */
|
||||
#undef HAVE_LIBCRYPTSETUP
|
||||
|
||||
/* Define if libcurl is available */
|
||||
#undef HAVE_LIBCURL
|
||||
|
||||
/* Define to 1 if you have the `dw' library (-ldw). */
|
||||
#undef HAVE_LIBDW
|
||||
|
||||
/* Define if libidn is available */
|
||||
#undef HAVE_LIBIDN
|
||||
|
||||
/* Define to 1 if you have the <linux/btrfs.h> header file. */
|
||||
#undef HAVE_LINUX_BTRFS_H
|
||||
|
||||
/* Define to 1 if you have the <linux/memfd.h> header file. */
|
||||
#undef HAVE_LINUX_MEMFD_H
|
||||
|
||||
/* Logind support available */
|
||||
#undef HAVE_LOGIND
|
||||
|
||||
/* Define in LZ4 is available */
|
||||
#undef HAVE_LZ4
|
||||
|
||||
/* Define to 1 if you have the <lz4.h> header file. */
|
||||
#undef HAVE_LZ4_H
|
||||
|
||||
/* Machined support available */
|
||||
#undef HAVE_MACHINED
|
||||
|
||||
@ -162,6 +179,9 @@
|
||||
to 0 otherwise. */
|
||||
#undef HAVE_MALLOC
|
||||
|
||||
/* Define to 1 if you have the `memfd_create' function. */
|
||||
#undef HAVE_MEMFD_CREATE
|
||||
|
||||
/* Define to 1 if you have the <memory.h> header file. */
|
||||
#undef HAVE_MEMORY_H
|
||||
|
||||
@ -279,6 +299,9 @@
|
||||
/* Define to 1 if you have the <unistd.h> header file. */
|
||||
#undef HAVE_UNISTD_H
|
||||
|
||||
/* Define if utmp/wtmp support is enabled */
|
||||
#undef HAVE_UTMP
|
||||
|
||||
/* Define to 1 if you have the <valgrind/memcheck.h> header file. */
|
||||
#undef HAVE_VALGRIND_MEMCHECK_H
|
||||
|
||||
@ -340,6 +363,9 @@
|
||||
/* Define to the type of arg 5 for `select'. */
|
||||
#undef SELECT_TYPE_ARG5
|
||||
|
||||
/* The size of `dev_t', as computed by sizeof. */
|
||||
#undef SIZEOF_DEV_T
|
||||
|
||||
/* The size of `gid_t', as computed by sizeof. */
|
||||
#undef SIZEOF_GID_T
|
||||
|
||||
|
||||
152
configure.ac
152
configure.ac
@ -20,7 +20,7 @@
|
||||
AC_PREREQ([2.64])
|
||||
|
||||
AC_INIT([systemd],
|
||||
[215],
|
||||
[217],
|
||||
[http://bugs.freedesktop.org/enter_bug.cgi?product=systemd],
|
||||
[systemd],
|
||||
[http://www.freedesktop.org/wiki/Software/systemd])
|
||||
@ -62,7 +62,7 @@ AS_IF([test x"$intltool_found" != xyes],
|
||||
])
|
||||
|
||||
AM_NLS
|
||||
AS_IF([test x"$enable_nls" != xno], [
|
||||
AS_IF([test x"$enable_nls" != xno -o "x$enable_polkit" != xno], [
|
||||
# intltoolize greps for '^(AC|IT)_PROG_INTLTOOL', so it needs to be on its own line
|
||||
IT_PROG_INTLTOOL([0.40.0])
|
||||
])
|
||||
@ -189,7 +189,6 @@ CC_CHECK_FLAGS_APPEND([with_cflags], [CFLAGS], [\
|
||||
-ffast-math \
|
||||
-fno-common \
|
||||
-fdiagnostics-show-option \
|
||||
-fdiagnostics-color \
|
||||
-fno-strict-aliasing \
|
||||
-fvisibility=hidden \
|
||||
-ffunction-sections \
|
||||
@ -198,6 +197,13 @@ CC_CHECK_FLAGS_APPEND([with_cflags], [CFLAGS], [\
|
||||
-fstack-protector-strong \
|
||||
-fPIE \
|
||||
--param=ssp-buffer-size=4])
|
||||
|
||||
AS_CASE([$CC], [*clang*],
|
||||
[CC_CHECK_FLAGS_APPEND([with_cppflags], [CPPFLAGS], [\
|
||||
-Wno-typedef-redefinition \
|
||||
-Wno-gnu-variable-sized-type-not-at-end \
|
||||
])])
|
||||
|
||||
AS_CASE([$CFLAGS], [*-O[[12345\ ]]*],
|
||||
[CC_CHECK_FLAGS_APPEND([with_cflags], [CFLAGS], [\
|
||||
-flto -ffat-lto-objects])],
|
||||
@ -224,6 +230,7 @@ AC_CHECK_SIZEOF(pid_t)
|
||||
AC_CHECK_SIZEOF(uid_t)
|
||||
AC_CHECK_SIZEOF(gid_t)
|
||||
AC_CHECK_SIZEOF(time_t)
|
||||
AC_CHECK_SIZEOF(dev_t)
|
||||
AC_CHECK_SIZEOF(rlim_t,,[
|
||||
#include <sys/time.h>
|
||||
#include <sys/resource.h>
|
||||
@ -282,6 +289,7 @@ AM_CONDITIONAL([HAVE_PYTHON_DEVEL], [test "$have_python_devel" = "yes"])
|
||||
AC_SEARCH_LIBS([dlsym], [dl], [], [AC_MSG_ERROR([*** Dynamic linking loader library not found])])
|
||||
AC_CHECK_HEADERS([sys/capability.h], [], [AC_MSG_ERROR([*** POSIX caps headers not found])])
|
||||
AC_CHECK_HEADERS([linux/btrfs.h], [], [])
|
||||
AC_CHECK_HEADERS([linux/memfd.h], [], [])
|
||||
|
||||
# unconditionally pull-in librt with old glibc versions
|
||||
AC_SEARCH_LIBS([clock_gettime], [rt], [], [])
|
||||
@ -298,7 +306,7 @@ RT_LIBS="$LIBS"
|
||||
AC_SUBST(RT_LIBS)
|
||||
LIBS="$save_LIBS"
|
||||
|
||||
AC_CHECK_FUNCS([fanotify_init fanotify_mark])
|
||||
AC_CHECK_FUNCS([memfd_create])
|
||||
AC_CHECK_FUNCS([__secure_getenv secure_getenv])
|
||||
AC_CHECK_DECLS([gettid, pivot_root, name_to_handle_at, setns, LO_FLAGS_PARTSCAN],
|
||||
[], [], [[
|
||||
@ -310,7 +318,9 @@ AC_CHECK_DECLS([gettid, pivot_root, name_to_handle_at, setns, LO_FLAGS_PARTSCAN]
|
||||
#include <linux/loop.h>
|
||||
]])
|
||||
|
||||
AC_CHECK_DECLS([IFLA_PHYS_PORT_ID,
|
||||
AC_CHECK_DECLS([IFLA_MACVLAN_FLAGS,
|
||||
IFLA_VTI_REMOTE,
|
||||
IFLA_PHYS_PORT_ID,
|
||||
IFLA_BOND_AD_INFO,
|
||||
IFLA_VLAN_PROTOCOL,
|
||||
IFLA_VXLAN_LOCAL6,
|
||||
@ -342,6 +352,16 @@ AS_IF([test "x$enable_dbus" != "xno"], [
|
||||
[AC_MSG_ERROR([*** dbus-1 support requested but libraries not found])])])
|
||||
AM_CONDITIONAL(HAVE_DBUS, [test "$have_dbus" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_utmp=yes
|
||||
AC_ARG_ENABLE([utmp], AS_HELP_STRING([--disable-utmp], [disable utmp/wtmp log handling]),
|
||||
AS_CASE("x${enableval}",
|
||||
[xyes], [have_utmp=yes],
|
||||
[xno], [have_utmp=no],
|
||||
AC_MSG_ERROR(bad value ${enableval} for --enable-utmp)))
|
||||
AS_IF([test "x$have_utmp" = "xyes"], [AC_DEFINE(HAVE_UTMP, 1, [Define if utmp/wtmp support is enabled])])
|
||||
AM_CONDITIONAL([HAVE_UTMP], [test "x$have_utmp" = "xyes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_compat_libs=no
|
||||
AC_ARG_ENABLE([compat_libs], AS_HELP_STRING([--enable-compat-libs],[Enable creation of compatibility libraries]),
|
||||
@ -498,18 +518,38 @@ AC_ARG_WITH([debug-tty],
|
||||
|
||||
AC_SUBST(DEBUGTTY)
|
||||
|
||||
AC_ARG_WITH([certificate-root],
|
||||
AS_HELP_STRING([--with-certificate-root=PATH],
|
||||
[Specify the prefix for TLS certificates [/etc/ssl]]),
|
||||
[CERTIFICATEROOT="$withval"],
|
||||
[CERTIFICATEROOT="/etc/ssl"])
|
||||
|
||||
AC_SUBST(CERTIFICATEROOT)
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_xz=no
|
||||
AC_ARG_ENABLE(xz, AS_HELP_STRING([--disable-xz], [Disable optional XZ support]))
|
||||
if test "x$enable_xz" != "xno"; then
|
||||
PKG_CHECK_MODULES(XZ, [ liblzma ],
|
||||
[AC_DEFINE(HAVE_XZ, 1, [Define if XZ is available]) have_xz=yes], have_xz=no)
|
||||
[AC_DEFINE(HAVE_XZ, 1, [Define if XZ is available]) have_xz=yes])
|
||||
if test "x$have_xz" = xno -a "x$enable_xz" = xyes; then
|
||||
AC_MSG_ERROR([*** Xz support requested but libraries not found])
|
||||
AC_MSG_ERROR([*** XZ support requested but libraries not found])
|
||||
fi
|
||||
fi
|
||||
AM_CONDITIONAL(HAVE_XZ, [test "$have_xz" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_lz4=no
|
||||
AC_ARG_ENABLE(lz4, AS_HELP_STRING([--enable-lz4], [Enable optional LZ4 support]))
|
||||
AS_IF([test "x$enable_lz4" == "xyes"], [
|
||||
AC_CHECK_HEADERS(lz4.h,
|
||||
[AC_DEFINE(HAVE_LZ4, 1, [Define in LZ4 is available]) have_lz4=yes],
|
||||
[AC_MSG_ERROR([*** LZ4 support requested but headers not found])])
|
||||
])
|
||||
AM_CONDITIONAL(HAVE_LZ4, [test "$have_lz4" = "yes"])
|
||||
|
||||
AM_CONDITIONAL(HAVE_COMPRESSION, [test "$have_xz" = "yes" -o "$have_lz4" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
AC_ARG_ENABLE([pam],
|
||||
AS_HELP_STRING([--disable-pam],[Disable optional PAM support]),
|
||||
@ -775,6 +815,33 @@ if test "x$enable_gnutls" != "xno"; then
|
||||
fi
|
||||
AM_CONDITIONAL(HAVE_GNUTLS, [test "$have_gnutls" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_libcurl=no
|
||||
AC_ARG_ENABLE(libcurl, AS_HELP_STRING([--disable-libcurl], [disable libcurl support]))
|
||||
if test "x$enable_libcurl" != "xno"; then
|
||||
PKG_CHECK_MODULES(LIBCURL, [libcurl],
|
||||
[AC_DEFINE(HAVE_LIBCURL, 1, [Define if libcurl is available]) have_libcurl=yes], have_libcurl=no)
|
||||
if test "x$have_libcurl" = xno -a "x$enable_libcurl" = xyes; then
|
||||
AC_MSG_ERROR([*** libcurl support requested but libraries not found])
|
||||
fi
|
||||
fi
|
||||
AM_CONDITIONAL(HAVE_LIBCURL, [test "$have_libcurl" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_libidn=no
|
||||
AC_ARG_ENABLE(libidn, AS_HELP_STRING([--disable-libidn], [Disable optional LIBIDN support]))
|
||||
if test "x$enable_libidn" != "xno"; then
|
||||
PKG_CHECK_MODULES(LIBIDN, [libidn],
|
||||
[AC_DEFINE(HAVE_LIBIDN, 1, [Define if libidn is available])
|
||||
have_libidn=yes
|
||||
M4_DEFINES="$M4_DEFINES -DHAVE_LIBIDN"],
|
||||
[have_libidn=no])
|
||||
if test "x$have_libidn" = "xno" -a "x$enable_libidn" = "xyes"; then
|
||||
AC_MSG_ERROR([*** libidn support requested but libraries not found])
|
||||
fi
|
||||
fi
|
||||
AM_CONDITIONAL(HAVE_LIBIDN, [test "$have_libidn" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_binfmt=no
|
||||
AC_ARG_ENABLE(binfmt, AS_HELP_STRING([--disable-binfmt], [disable binfmt tool]))
|
||||
@ -791,14 +858,6 @@ if test "x$enable_vconsole" != "xno"; then
|
||||
fi
|
||||
AM_CONDITIONAL(ENABLE_VCONSOLE, [test "$have_vconsole" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_readahead=no
|
||||
AC_ARG_ENABLE(readahead, AS_HELP_STRING([--disable-readahead], [disable readahead tools]))
|
||||
if test "x$enable_readahead" != "xno"; then
|
||||
have_readahead=yes
|
||||
fi
|
||||
AM_CONDITIONAL(ENABLE_READAHEAD, [test "$have_readahead" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_bootchart=no
|
||||
AC_ARG_ENABLE(bootchart, AS_HELP_STRING([--disable-bootchart], [disable bootchart tool]))
|
||||
@ -831,6 +890,14 @@ if test "x$enable_sysusers" != "xno"; then
|
||||
fi
|
||||
AM_CONDITIONAL(ENABLE_SYSUSERS, [test "$have_sysusers" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_firstboot=no
|
||||
AC_ARG_ENABLE(firstboot, AS_HELP_STRING([--disable-firstboot], [disable firstboot support]))
|
||||
if test "x$enable_firstboot" != "xno"; then
|
||||
have_firstboot=yes
|
||||
fi
|
||||
AM_CONDITIONAL(ENABLE_FIRSTBOOT, [test "$have_firstboot" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_randomseed=no
|
||||
AC_ARG_ENABLE(randomseed, AS_HELP_STRING([--disable-randomseed], [disable randomseed tools]))
|
||||
@ -964,6 +1031,7 @@ have_resolved=no
|
||||
AC_ARG_ENABLE(resolved, AS_HELP_STRING([--disable-resolved], [disable resolve daemon]))
|
||||
if test "x$enable_resolved" != "xno"; then
|
||||
have_resolved=yes
|
||||
M4_DEFINES="$M4_DEFINES -DENABLE_RESOLVED"
|
||||
fi
|
||||
AM_CONDITIONAL(ENABLE_RESOLVED, [test "$have_resolved" = "yes"])
|
||||
|
||||
@ -995,12 +1063,16 @@ fi
|
||||
AM_CONDITIONAL(ENABLE_EFI, [test "x$have_efi" = "xyes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_multi_seat_x=no
|
||||
AC_ARG_ENABLE(multi_seat_x, AS_HELP_STRING([--disable-multi-seat-x], [do not build multi-seat-x]))
|
||||
if test "x$enable_multi_seat_x" != "xno"; then
|
||||
have_multi_seat_x=yes
|
||||
have_terminal=no
|
||||
AC_ARG_ENABLE(terminal, AS_HELP_STRING([--enable-terminal], [enable terminal support]))
|
||||
if test "x$enable_terminal" = "xyes"; then
|
||||
PKG_CHECK_MODULES([TERMINAL], [ libevdev >= 1.2 xkbcommon >= 0.4 libdrm >= 2.4], [have_terminal=yes])
|
||||
AS_IF([test "x$have_terminal" != xyes -a "x$enable_terminal" = xyes],
|
||||
[AC_MSG_ERROR([*** terminal support requested but required dependencies not available])],
|
||||
[test "x$have_terminal" = xyes],
|
||||
[AC_DEFINE(ENABLE_TERMINAL, 1, [Define if terminal support is to be enabled])])
|
||||
fi
|
||||
AM_CONDITIONAL(ENABLE_MULTI_SEAT_X, [test "$have_multi_seat_x" = "yes"])
|
||||
AM_CONDITIONAL(ENABLE_TERMINAL, [test "x$have_terminal" = "xyes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
have_kdbus=no
|
||||
@ -1081,25 +1153,6 @@ if test "x$enable_myhostname" != "xno"; then
|
||||
fi
|
||||
AM_CONDITIONAL(HAVE_MYHOSTNAME, [test "$have_myhostname" = "yes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
AC_ARG_WITH(firmware-path,
|
||||
AS_HELP_STRING([--with-firmware-path=DIR[[[:DIR[...]]]]],
|
||||
[Firmware search path (default="")]),
|
||||
[], [with_firmware_path=""])
|
||||
OLD_IFS=$IFS
|
||||
IFS=:
|
||||
for i in $with_firmware_path; do
|
||||
if test "x${FIRMWARE_PATH}" = "x"; then
|
||||
FIRMWARE_PATH="\\\"${i}/\\\""
|
||||
else
|
||||
FIRMWARE_PATH="${FIRMWARE_PATH}, \\\"${i}/\\\""
|
||||
fi
|
||||
done
|
||||
IFS=$OLD_IFS
|
||||
AC_SUBST(FIRMWARE_PATH)
|
||||
AS_IF([test "x${FIRMWARE_PATH}" != "x"], [ AC_DEFINE(HAVE_FIRMWARE, 1, [Define if FIRMWARE is available]) ])
|
||||
AM_CONDITIONAL(ENABLE_FIRMWARE, [test "x${FIRMWARE_PATH}" != "x"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
AC_ARG_ENABLE([gudev],
|
||||
AS_HELP_STRING([--disable-gudev], [disable Gobject libudev support @<:@default=enabled@:>@]),
|
||||
@ -1115,7 +1168,18 @@ AS_IF([test "x$enable_manpages" != xno], [have_manpages=yes])
|
||||
AM_CONDITIONAL(ENABLE_MANPAGES, [test "x$have_manpages" = "xyes"])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
AC_ARG_ENABLE(hibernate,
|
||||
[AC_HELP_STRING([--disable-hibernate], [disable hibernation support])],
|
||||
enable_hibernate=$enableval, enable_hibernate=yes)
|
||||
AM_CONDITIONAL(ENABLE_HIBERNATE, [test x$enable_hibernate = xyes])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
AC_ARG_ENABLE(ldconfig,
|
||||
[AC_HELP_STRING([--disable-ldconfig], [disable ldconfig])],
|
||||
enable_ldconfig=$enableval, enable_ldconfig=yes)
|
||||
AM_CONDITIONAL(ENABLE_LDCONFIG, [test x$enable_ldconfig = xyes])
|
||||
|
||||
# ------------------------------------------------------------------------------
|
||||
# Location of the init scripts as mandated by LSB
|
||||
SYSTEM_SYSVINIT_PATH=/etc/init.d
|
||||
SYSTEM_SYSVRCND_PATH=/etc/rc.d
|
||||
@ -1266,20 +1330,23 @@ AC_MSG_RESULT([
|
||||
SECCOMP: ${have_seccomp}
|
||||
SMACK: ${have_smack}
|
||||
XZ: ${have_xz}
|
||||
LZ4: ${have_lz4}
|
||||
ACL: ${have_acl}
|
||||
GCRYPT: ${have_gcrypt}
|
||||
QRENCODE: ${have_qrencode}
|
||||
MICROHTTPD: ${have_microhttpd}
|
||||
CHKCONFIG: ${have_chkconfig}
|
||||
GNUTLS: ${have_gnutls}
|
||||
libcurl: ${have_libcurl}
|
||||
libidn: ${have_libidn}
|
||||
ELFUTILS: ${have_elfutils}
|
||||
binfmt: ${have_binfmt}
|
||||
vconsole: ${have_vconsole}
|
||||
readahead: ${have_readahead}
|
||||
bootchart: ${have_bootchart}
|
||||
quotacheck: ${have_quotacheck}
|
||||
tmpfiles: ${have_tmpfiles}
|
||||
sysusers: ${have_sysusers}
|
||||
firstboot: ${have_firstboot}
|
||||
randomseed: ${have_randomseed}
|
||||
backlight: ${have_backlight}
|
||||
rfkill: ${have_rfkill}
|
||||
@ -1303,7 +1370,7 @@ AC_MSG_RESULT([
|
||||
nss-myhostname: ${have_myhostname}
|
||||
gudev: ${enable_gudev}
|
||||
gintrospection: ${enable_introspection}
|
||||
multi-seat-x: ${have_multi_seat_x}
|
||||
terminal: ${have_terminal}
|
||||
kdbus: ${have_kdbus}
|
||||
Python: ${have_python}
|
||||
Python Headers: ${have_python_devel}
|
||||
@ -1313,6 +1380,7 @@ AC_MSG_RESULT([
|
||||
Split /usr: ${enable_split_usr}
|
||||
SysV compatibility: ${SYSTEM_SYSV_COMPAT}
|
||||
compatibility libraries: ${have_compat_libs}
|
||||
utmp/wtmp support: ${have_utmp}
|
||||
|
||||
prefix: ${prefix}
|
||||
rootprefix: ${with_rootprefix}
|
||||
@ -1327,7 +1395,6 @@ AC_MSG_RESULT([
|
||||
Build Python: ${PYTHON}
|
||||
Installation Python: ${PYTHON_BINARY}
|
||||
sphinx binary: ${SPHINX_BUILD}
|
||||
firmware path: ${FIRMWARE_PATH}
|
||||
PAM modules dir: ${with_pamlibdir}
|
||||
PAM configuration dir: ${with_pamconfdir}
|
||||
D-Bus policy dir: ${with_dbuspolicydir}
|
||||
@ -1342,6 +1409,7 @@ AC_MSG_RESULT([
|
||||
TTY GID: ${TTY_GID}
|
||||
Maximum System UID: ${SYSTEM_UID_MAX}
|
||||
Maximum System GID: ${SYSTEM_GID_MAX}
|
||||
Certificate root: ${CERTIFICATEROOT}
|
||||
|
||||
CFLAGS: ${OUR_CFLAGS} ${CFLAGS}
|
||||
CPPFLAGS: ${OUR_CPPFLAGS} ${CPPFLAGS}
|
||||
|
||||
@ -137,6 +137,7 @@ BLKID_LIBS = @BLKID_LIBS@
|
||||
CAP_LIBS = @CAP_LIBS@
|
||||
CC = @CC@
|
||||
CCDEPMODE = @CCDEPMODE@
|
||||
CERTIFICATEROOT = @CERTIFICATEROOT@
|
||||
CFLAGS = @CFLAGS@
|
||||
CHKCONFIG = @CHKCONFIG@
|
||||
CPP = @CPP@
|
||||
@ -159,7 +160,6 @@ EGREP = @EGREP@
|
||||
ELFUTILS_LIBS = @ELFUTILS_LIBS@
|
||||
EXEEXT = @EXEEXT@
|
||||
FGREP = @FGREP@
|
||||
FIRMWARE_PATH = @FIRMWARE_PATH@
|
||||
GCRYPT_CFLAGS = @GCRYPT_CFLAGS@
|
||||
GCRYPT_LIBS = @GCRYPT_LIBS@
|
||||
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
|
||||
@ -208,9 +208,13 @@ LD = @LD@
|
||||
LDFLAGS = @LDFLAGS@
|
||||
LIBCRYPTSETUP_CFLAGS = @LIBCRYPTSETUP_CFLAGS@
|
||||
LIBCRYPTSETUP_LIBS = @LIBCRYPTSETUP_LIBS@
|
||||
LIBCURL_CFLAGS = @LIBCURL_CFLAGS@
|
||||
LIBCURL_LIBS = @LIBCURL_LIBS@
|
||||
LIBGCRYPT_CFLAGS = @LIBGCRYPT_CFLAGS@
|
||||
LIBGCRYPT_CONFIG = @LIBGCRYPT_CONFIG@
|
||||
LIBGCRYPT_LIBS = @LIBGCRYPT_LIBS@
|
||||
LIBIDN_CFLAGS = @LIBIDN_CFLAGS@
|
||||
LIBIDN_LIBS = @LIBIDN_LIBS@
|
||||
LIBOBJS = @LIBOBJS@
|
||||
LIBS = @LIBS@
|
||||
LIBTOOL = @LIBTOOL@
|
||||
@ -281,6 +285,8 @@ SYSTEM_SYSVINIT_PATH = @SYSTEM_SYSVINIT_PATH@
|
||||
SYSTEM_SYSVRCND_PATH = @SYSTEM_SYSVRCND_PATH@
|
||||
SYSTEM_UID_MAX = @SYSTEM_UID_MAX@
|
||||
TELINIT = @TELINIT@
|
||||
TERMINAL_CFLAGS = @TERMINAL_CFLAGS@
|
||||
TERMINAL_LIBS = @TERMINAL_LIBS@
|
||||
TTY_GID = @TTY_GID@
|
||||
USE_NLS = @USE_NLS@
|
||||
VERSION = @VERSION@
|
||||
|
||||
@ -15,7 +15,7 @@
|
||||
<div>
|
||||
<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">GUdev Reference Manual</p></th></tr></table></div>
|
||||
<div><p class="releaseinfo">
|
||||
For version 215
|
||||
For version 217
|
||||
— the latest version of this
|
||||
documentation can be found at
|
||||
<a class="ulink" href="http://www.freedesktop.org/software/systemd/gudev/" target="_top">
|
||||
|
||||
@ -1 +1 @@
|
||||
215
|
||||
217
|
||||
|
||||
@ -137,6 +137,7 @@ BLKID_LIBS = @BLKID_LIBS@
|
||||
CAP_LIBS = @CAP_LIBS@
|
||||
CC = @CC@
|
||||
CCDEPMODE = @CCDEPMODE@
|
||||
CERTIFICATEROOT = @CERTIFICATEROOT@
|
||||
CFLAGS = @CFLAGS@
|
||||
CHKCONFIG = @CHKCONFIG@
|
||||
CPP = @CPP@
|
||||
@ -159,7 +160,6 @@ EGREP = @EGREP@
|
||||
ELFUTILS_LIBS = @ELFUTILS_LIBS@
|
||||
EXEEXT = @EXEEXT@
|
||||
FGREP = @FGREP@
|
||||
FIRMWARE_PATH = @FIRMWARE_PATH@
|
||||
GCRYPT_CFLAGS = @GCRYPT_CFLAGS@
|
||||
GCRYPT_LIBS = @GCRYPT_LIBS@
|
||||
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
|
||||
@ -208,9 +208,13 @@ LD = @LD@
|
||||
LDFLAGS = @LDFLAGS@
|
||||
LIBCRYPTSETUP_CFLAGS = @LIBCRYPTSETUP_CFLAGS@
|
||||
LIBCRYPTSETUP_LIBS = @LIBCRYPTSETUP_LIBS@
|
||||
LIBCURL_CFLAGS = @LIBCURL_CFLAGS@
|
||||
LIBCURL_LIBS = @LIBCURL_LIBS@
|
||||
LIBGCRYPT_CFLAGS = @LIBGCRYPT_CFLAGS@
|
||||
LIBGCRYPT_CONFIG = @LIBGCRYPT_CONFIG@
|
||||
LIBGCRYPT_LIBS = @LIBGCRYPT_LIBS@
|
||||
LIBIDN_CFLAGS = @LIBIDN_CFLAGS@
|
||||
LIBIDN_LIBS = @LIBIDN_LIBS@
|
||||
LIBOBJS = @LIBOBJS@
|
||||
LIBS = @LIBS@
|
||||
LIBTOOL = @LIBTOOL@
|
||||
@ -281,6 +285,8 @@ SYSTEM_SYSVINIT_PATH = @SYSTEM_SYSVINIT_PATH@
|
||||
SYSTEM_SYSVRCND_PATH = @SYSTEM_SYSVRCND_PATH@
|
||||
SYSTEM_UID_MAX = @SYSTEM_UID_MAX@
|
||||
TELINIT = @TELINIT@
|
||||
TERMINAL_CFLAGS = @TERMINAL_CFLAGS@
|
||||
TERMINAL_LIBS = @TERMINAL_LIBS@
|
||||
TTY_GID = @TTY_GID@
|
||||
USE_NLS = @USE_NLS@
|
||||
VERSION = @VERSION@
|
||||
|
||||
@ -15,7 +15,7 @@
|
||||
<div>
|
||||
<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">libudev Reference Manual</p></th></tr></table></div>
|
||||
<div><p class="releaseinfo">
|
||||
For version 215
|
||||
For version 217
|
||||
— the latest version of this
|
||||
documentation can be found at
|
||||
<a class="ulink" href="http://www.freedesktop.org/software/systemd/libudev/" target="_top">
|
||||
|
||||
@ -1 +1 @@
|
||||
215
|
||||
217
|
||||
|
||||
6
factory/etc/nsswitch.conf
Normal file
6
factory/etc/nsswitch.conf
Normal file
@ -0,0 +1,6 @@
|
||||
# This file is part of systemd.
|
||||
|
||||
passwd: files
|
||||
shadow: files
|
||||
group: files
|
||||
hosts: files mymachines resolve myhostname
|
||||
6
factory/etc/pam.d/other
Normal file
6
factory/etc/pam.d/other
Normal file
@ -0,0 +1,6 @@
|
||||
# This file is part of systemd.
|
||||
|
||||
auth include system-auth
|
||||
account include system-auth
|
||||
password include system-auth
|
||||
session include system-auth
|
||||
12
factory/etc/pam.d/system-auth
Normal file
12
factory/etc/pam.d/system-auth
Normal file
@ -0,0 +1,12 @@
|
||||
# This file is part of systemd.
|
||||
|
||||
auth sufficient pam_unix.so nullok try_first_pass
|
||||
|
||||
account required pam_nologin.so
|
||||
account sufficient pam_unix.so
|
||||
|
||||
password sufficient pam_unix.so nullok sha512 shadow try_first_pass try_authtok
|
||||
|
||||
-session optional pam_loginuid.so
|
||||
-session optional pam_systemd.so
|
||||
session sufficient pam_unix.so
|
||||
804
hwdb/20-OUI.hwdb
804
hwdb/20-OUI.hwdb
File diff suppressed because it is too large
Load Diff
@ -184,7 +184,7 @@ bluetooth:v003B*
|
||||
ID_VENDOR_FROM_DATABASE=Gennum Corporation
|
||||
|
||||
bluetooth:v003C*
|
||||
ID_VENDOR_FROM_DATABASE=Research In Motion
|
||||
ID_VENDOR_FROM_DATABASE=BlackBerry Limited (formerly Research In Motion)
|
||||
|
||||
bluetooth:v003D*
|
||||
ID_VENDOR_FROM_DATABASE=IPextreme, Inc.
|
||||
@ -1073,3 +1073,96 @@ bluetooth:v0162*
|
||||
|
||||
bluetooth:v0163*
|
||||
ID_VENDOR_FROM_DATABASE=PCH International
|
||||
|
||||
bluetooth:v0164*
|
||||
ID_VENDOR_FROM_DATABASE=Qingdao Yeelink Information Technology Co., Ltd.
|
||||
|
||||
bluetooth:v0165*
|
||||
ID_VENDOR_FROM_DATABASE=Milwaukee Tool (formerly Milwaukee Electric Tools)
|
||||
|
||||
bluetooth:v0166*
|
||||
ID_VENDOR_FROM_DATABASE=MISHIK Pte Ltd
|
||||
|
||||
bluetooth:v0167*
|
||||
ID_VENDOR_FROM_DATABASE=Bayer HealthCare
|
||||
|
||||
bluetooth:v0168*
|
||||
ID_VENDOR_FROM_DATABASE=Spicebox LLC
|
||||
|
||||
bluetooth:v0169*
|
||||
ID_VENDOR_FROM_DATABASE=emberlight
|
||||
|
||||
bluetooth:v016A*
|
||||
ID_VENDOR_FROM_DATABASE=Cooper-Atkins Corporation
|
||||
|
||||
bluetooth:v016B*
|
||||
ID_VENDOR_FROM_DATABASE=Qblinks
|
||||
|
||||
bluetooth:v016C*
|
||||
ID_VENDOR_FROM_DATABASE=MYSPHERA
|
||||
|
||||
bluetooth:v016D*
|
||||
ID_VENDOR_FROM_DATABASE=LifeScan Inc
|
||||
|
||||
bluetooth:v016E*
|
||||
ID_VENDOR_FROM_DATABASE=Volantic AB
|
||||
|
||||
bluetooth:v016F*
|
||||
ID_VENDOR_FROM_DATABASE=Podo Labs, Inc
|
||||
|
||||
bluetooth:v0170*
|
||||
ID_VENDOR_FROM_DATABASE=Roche Diabetes Care AG
|
||||
|
||||
bluetooth:v0171*
|
||||
ID_VENDOR_FROM_DATABASE=Amazon Fulfillment Service
|
||||
|
||||
bluetooth:v0172*
|
||||
ID_VENDOR_FROM_DATABASE=Connovate Technology Private Limited
|
||||
|
||||
bluetooth:v0173*
|
||||
ID_VENDOR_FROM_DATABASE=Kocomojo, LLC
|
||||
|
||||
bluetooth:v0174*
|
||||
ID_VENDOR_FROM_DATABASE=Everykey LLC
|
||||
|
||||
bluetooth:v0175*
|
||||
ID_VENDOR_FROM_DATABASE=Dynamic Controls
|
||||
|
||||
bluetooth:v0176*
|
||||
ID_VENDOR_FROM_DATABASE=SentriLock
|
||||
|
||||
bluetooth:v0177*
|
||||
ID_VENDOR_FROM_DATABASE=I-SYST inc.
|
||||
|
||||
bluetooth:v0178*
|
||||
ID_VENDOR_FROM_DATABASE=CASIO COMPUTER CO., LTD.
|
||||
|
||||
bluetooth:v0179*
|
||||
ID_VENDOR_FROM_DATABASE=LAPIS Semiconductor Co., Ltd.
|
||||
|
||||
bluetooth:v017A*
|
||||
ID_VENDOR_FROM_DATABASE=Telemonitor, Inc.
|
||||
|
||||
bluetooth:v017B*
|
||||
ID_VENDOR_FROM_DATABASE=taskit GmbH
|
||||
|
||||
bluetooth:v017C*
|
||||
ID_VENDOR_FROM_DATABASE=Daimler AG
|
||||
|
||||
bluetooth:v017D*
|
||||
ID_VENDOR_FROM_DATABASE=BatAndCat
|
||||
|
||||
bluetooth:v017E*
|
||||
ID_VENDOR_FROM_DATABASE=BluDotz Ltd
|
||||
|
||||
bluetooth:v017F*
|
||||
ID_VENDOR_FROM_DATABASE=XTel ApS
|
||||
|
||||
bluetooth:v0180*
|
||||
ID_VENDOR_FROM_DATABASE=Gigaset Communications GmbH
|
||||
|
||||
bluetooth:v0181*
|
||||
ID_VENDOR_FROM_DATABASE=Gecko Health Innovations, Inc.
|
||||
|
||||
bluetooth:v0182*
|
||||
ID_VENDOR_FROM_DATABASE=HOP Ubiquitous
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -524,6 +524,9 @@ usb:v03F0p0317*
|
||||
usb:v03F0p0324*
|
||||
ID_MODEL_FROM_DATABASE=SK-2885 keyboard
|
||||
|
||||
usb:v03F0p034A*
|
||||
ID_MODEL_FROM_DATABASE=Elite Keyboard
|
||||
|
||||
usb:v03F0p0401*
|
||||
ID_MODEL_FROM_DATABASE=ScanJet 5200c
|
||||
|
||||
@ -767,6 +770,9 @@ usb:v03F0p1317*
|
||||
usb:v03F0p1327*
|
||||
ID_MODEL_FROM_DATABASE=iLO Virtual Hub
|
||||
|
||||
usb:v03F0p134A*
|
||||
ID_MODEL_FROM_DATABASE=Optical Mouse
|
||||
|
||||
usb:v03F0p1405*
|
||||
ID_MODEL_FROM_DATABASE=ScanJet 3670
|
||||
|
||||
@ -2336,6 +2342,12 @@ usb:v0403pEF10*
|
||||
usb:v0403pF070*
|
||||
ID_MODEL_FROM_DATABASE=Serial Converter 422/485 [Vardaan VEUSB422R3]
|
||||
|
||||
usb:v0403pF0C8*
|
||||
ID_MODEL_FROM_DATABASE=SPROG Decoder Programmer
|
||||
|
||||
usb:v0403pF0C9*
|
||||
ID_MODEL_FROM_DATABASE=SPROG-DCC CAN-USB
|
||||
|
||||
usb:v0403pF0E9*
|
||||
ID_MODEL_FROM_DATABASE=Tagsys L-P101
|
||||
|
||||
@ -2642,6 +2654,9 @@ usb:v0409p02B4*
|
||||
usb:v0409p02B6*
|
||||
ID_MODEL_FROM_DATABASE=Aterm WL300NU-GS 802.11n Wireless Adapter
|
||||
|
||||
usb:v0409p02BC*
|
||||
ID_MODEL_FROM_DATABASE=Computer Monitor
|
||||
|
||||
usb:v0409p0300*
|
||||
ID_MODEL_FROM_DATABASE=LifeTouch Note
|
||||
|
||||
@ -5348,6 +5363,9 @@ usb:v0452p0050*
|
||||
usb:v0452p0051*
|
||||
ID_MODEL_FROM_DATABASE=Integrated Hub
|
||||
|
||||
usb:v0452p0100*
|
||||
ID_MODEL_FROM_DATABASE=Control Panel for Leica TCS SP5
|
||||
|
||||
usb:v0453*
|
||||
ID_VENDOR_FROM_DATABASE=CMD Technology
|
||||
|
||||
@ -8759,6 +8777,9 @@ usb:v0480pA009*
|
||||
usb:v0480pA00D*
|
||||
ID_MODEL_FROM_DATABASE=STOR.E BASICS 500GB
|
||||
|
||||
usb:v0480pB001*
|
||||
ID_MODEL_FROM_DATABASE=Stor.E Partner
|
||||
|
||||
usb:v0480pD010*
|
||||
ID_MODEL_FROM_DATABASE=External Disk 3TB
|
||||
|
||||
@ -11222,6 +11243,9 @@ usb:v04A9p3261*
|
||||
usb:v04A9p3262*
|
||||
ID_MODEL_FROM_DATABASE=PowerShot A2600
|
||||
|
||||
usb:v04A9p3263*
|
||||
ID_MODEL_FROM_DATABASE=PowerShot SX275 HS
|
||||
|
||||
usb:v04A9p3264*
|
||||
ID_MODEL_FROM_DATABASE=PowerShot A1400
|
||||
|
||||
@ -11240,6 +11264,9 @@ usb:v04A9p3276*
|
||||
usb:v04A9p3277*
|
||||
ID_MODEL_FROM_DATABASE=PowerShot SX510 HS
|
||||
|
||||
usb:v04A9p3278*
|
||||
ID_MODEL_FROM_DATABASE=PowerShot S200
|
||||
|
||||
usb:v04A9p327D*
|
||||
ID_MODEL_FROM_DATABASE=Powershot ELPH 115 IS / IXUS 132
|
||||
|
||||
@ -11645,6 +11672,9 @@ usb:v04B4p2050*
|
||||
usb:v04B4p2830*
|
||||
ID_MODEL_FROM_DATABASE=Opera1 DVB-S (cold state)
|
||||
|
||||
usb:v04B4p3813*
|
||||
ID_MODEL_FROM_DATABASE=NANO BIOS Programmer
|
||||
|
||||
usb:v04B4p4235*
|
||||
ID_MODEL_FROM_DATABASE=Monitor 02 Driver
|
||||
|
||||
@ -13100,9 +13130,15 @@ usb:v04D8p900A*
|
||||
usb:v04D8pC001*
|
||||
ID_MODEL_FROM_DATABASE=PicoLCD 20x4
|
||||
|
||||
usb:v04D8pF4B5*
|
||||
ID_MODEL_FROM_DATABASE=SmartScope
|
||||
|
||||
usb:v04D8pF8DA*
|
||||
ID_MODEL_FROM_DATABASE=Hughski Ltd. ColorHug
|
||||
|
||||
usb:v04D8pF91C*
|
||||
ID_MODEL_FROM_DATABASE=SPROG IIv3
|
||||
|
||||
usb:v04D8pFAFF*
|
||||
ID_MODEL_FROM_DATABASE=Dangerous Prototypes BusPirate v4 Bootloader mode
|
||||
|
||||
@ -13118,6 +13154,9 @@ usb:v04D8pFBBA*
|
||||
usb:v04D8pFBBB*
|
||||
ID_MODEL_FROM_DATABASE=DiscFerret Magnetic Disc Analyser (active mode)
|
||||
|
||||
usb:v04D8pFC1E*
|
||||
ID_MODEL_FROM_DATABASE=Bachrus Speedometer Interface
|
||||
|
||||
usb:v04D8pFC92*
|
||||
ID_MODEL_FROM_DATABASE=Open Bench Logic Sniffer
|
||||
|
||||
@ -14432,6 +14471,9 @@ usb:v04F2p0403*
|
||||
usb:v04F2p0418*
|
||||
ID_MODEL_FROM_DATABASE=KU-0418 Tactical Pad
|
||||
|
||||
usb:v04F2p0618*
|
||||
ID_MODEL_FROM_DATABASE=RG-0618U Wireless HID Receiver & KG-0609 Wireless Keyboard with Touchpad
|
||||
|
||||
usb:v04F2p0760*
|
||||
ID_MODEL_FROM_DATABASE=Acer KU-0760 Keyboard
|
||||
|
||||
@ -15336,7 +15378,7 @@ usb:v04FCp0171*
|
||||
ID_MODEL_FROM_DATABASE=SPCA1527A/SPCA1528 SD card camera (Mass Storage mode)
|
||||
|
||||
usb:v04FCp0201*
|
||||
ID_MODEL_FROM_DATABASE=RS232C Adapter
|
||||
ID_MODEL_FROM_DATABASE=SPCP825 RS232C Adapter
|
||||
|
||||
usb:v04FCp0232*
|
||||
ID_MODEL_FROM_DATABASE=Fingerprint
|
||||
@ -29036,6 +29078,9 @@ usb:v08E3p0301*
|
||||
usb:v08E4*
|
||||
ID_VENDOR_FROM_DATABASE=Pioneer Corp.
|
||||
|
||||
usb:v08E4p0185*
|
||||
ID_MODEL_FROM_DATABASE=DDJ-WeGO2
|
||||
|
||||
usb:v08E5*
|
||||
ID_VENDOR_FROM_DATABASE=Litronic
|
||||
|
||||
@ -30177,7 +30222,7 @@ usb:v0930p6544*
|
||||
ID_MODEL_FROM_DATABASE=Kingston DataTraveler 2.0 Stick (2GB)
|
||||
|
||||
usb:v0930p6545*
|
||||
ID_MODEL_FROM_DATABASE=Kingston DataTraveler 102 Flash Drive / HEMA Flash Drive 2 GB / PNY Attache 4GB Stick
|
||||
ID_MODEL_FROM_DATABASE=Kingston DataTraveler 102/2.0 / HEMA Flash Drive 2 GB / PNY Attache 4GB Stick
|
||||
|
||||
usb:v0931*
|
||||
ID_VENDOR_FROM_DATABASE=Harmonic Data Systems, Ltd
|
||||
@ -33080,6 +33125,12 @@ usb:v0B48p300D*
|
||||
usb:v0B48p300E*
|
||||
ID_MODEL_FROM_DATABASE=TT-connect C-2400
|
||||
|
||||
usb:v0B48p3012*
|
||||
ID_MODEL_FROM_DATABASE=TT-connect CT2-4650 CI
|
||||
|
||||
usb:v0B48p3014*
|
||||
ID_MODEL_FROM_DATABASE=TT-TVStick CT2-4400
|
||||
|
||||
usb:v0B49*
|
||||
ID_VENDOR_FROM_DATABASE=ASCII Corp.
|
||||
|
||||
@ -34086,7 +34137,7 @@ usb:v0BC2p3101*
|
||||
ID_MODEL_FROM_DATABASE=FreeAgent XTreme 640GB
|
||||
|
||||
usb:v0BC2p3312*
|
||||
ID_MODEL_FROM_DATABASE=SRD00F2 [Expansion Desktop Drive 2TB]
|
||||
ID_MODEL_FROM_DATABASE=SRD00F2 Expansion Desktop Drive (STBV)
|
||||
|
||||
usb:v0BC2p3320*
|
||||
ID_MODEL_FROM_DATABASE=SRD00F2 [Expansion Desktop Drive]
|
||||
@ -34109,6 +34160,9 @@ usb:v0BC2p5031*
|
||||
usb:v0BC2p5070*
|
||||
ID_MODEL_FROM_DATABASE=FreeAgent GoFlex Desk
|
||||
|
||||
usb:v0BC2p5071*
|
||||
ID_MODEL_FROM_DATABASE=FreeAgent GoFlex Desk
|
||||
|
||||
usb:v0BC2p50A1*
|
||||
ID_MODEL_FROM_DATABASE=FreeAgent GoFlex Desk
|
||||
|
||||
@ -34133,6 +34187,9 @@ usb:v0BC2pA0A4*
|
||||
usb:v0BC2pAB00*
|
||||
ID_MODEL_FROM_DATABASE=Slim Portable Drive
|
||||
|
||||
usb:v0BC2pAB20*
|
||||
ID_MODEL_FROM_DATABASE=Backup Plus Portable Drive
|
||||
|
||||
usb:v0BC3*
|
||||
ID_VENDOR_FROM_DATABASE=IPWireless, Inc.
|
||||
|
||||
@ -34301,6 +34358,9 @@ usb:v0BDAp0176*
|
||||
usb:v0BDAp0178*
|
||||
ID_MODEL_FROM_DATABASE=Mass Storage Device
|
||||
|
||||
usb:v0BDAp0179*
|
||||
ID_MODEL_FROM_DATABASE=RTL8188ETV Wireless LAN 802.11n Network Adapter
|
||||
|
||||
usb:v0BDAp0184*
|
||||
ID_MODEL_FROM_DATABASE=RTS5182 Card Reader
|
||||
|
||||
@ -34322,6 +34382,9 @@ usb:v0BDAp2832*
|
||||
usb:v0BDAp2838*
|
||||
ID_MODEL_FROM_DATABASE=RTL2838 DVB-T
|
||||
|
||||
usb:v0BDAp5730*
|
||||
ID_MODEL_FROM_DATABASE=HP 2.0MP High Definition Webcam
|
||||
|
||||
usb:v0BDAp8150*
|
||||
ID_MODEL_FROM_DATABASE=RTL8150 Fast Ethernet Adapter
|
||||
|
||||
@ -36012,11 +36075,53 @@ usb:v0CE5p0003*
|
||||
ID_MODEL_FROM_DATABASE=Matrix
|
||||
|
||||
usb:v0CE9*
|
||||
ID_VENDOR_FROM_DATABASE=pico Technology
|
||||
ID_VENDOR_FROM_DATABASE=Pico Technology
|
||||
|
||||
usb:v0CE9p1001*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope3000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1007*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 2000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1008*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 5000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1009*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 4000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p100E*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 6000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1012*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 3000A series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1016*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 2000A series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1018*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 4000A series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1200*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 2000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1201*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 3000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1202*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 4000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1203*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 5000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1204*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 6000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1211*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 3000 series PC Oscilloscope
|
||||
|
||||
usb:v0CE9p1212*
|
||||
ID_MODEL_FROM_DATABASE=PicoScope 4000 series PC Oscilloscope
|
||||
|
||||
usb:v0CF1*
|
||||
ID_VENDOR_FROM_DATABASE=e-Conn Electronic Co., Ltd
|
||||
|
||||
@ -36998,6 +37103,9 @@ usb:v0DB0p1020*
|
||||
usb:v0DB0p1967*
|
||||
ID_MODEL_FROM_DATABASE=Bluetooth Dongle
|
||||
|
||||
usb:v0DB0p3713*
|
||||
ID_MODEL_FROM_DATABASE=Primo 73
|
||||
|
||||
usb:v0DB0p3801*
|
||||
ID_MODEL_FROM_DATABASE=Motorola Bluetooth 2.1+EDR Device
|
||||
|
||||
@ -37112,6 +37220,9 @@ usb:v0DB7p0002*
|
||||
usb:v0DBA*
|
||||
ID_VENDOR_FROM_DATABASE=Digidesign
|
||||
|
||||
usb:v0DBAp1000*
|
||||
ID_MODEL_FROM_DATABASE=Mbox 1 [Mbox]
|
||||
|
||||
usb:v0DBAp3000*
|
||||
ID_MODEL_FROM_DATABASE=Mbox 2
|
||||
|
||||
@ -37913,6 +38024,12 @@ usb:v0E6A*
|
||||
usb:v0E6Ap0101*
|
||||
ID_MODEL_FROM_DATABASE=MA100 [USB-UART Bridge IC]
|
||||
|
||||
usb:v0E6Ap030B*
|
||||
ID_MODEL_FROM_DATABASE=Truly Ergonomic Computer Keyboard (Device Firmware Update mode)
|
||||
|
||||
usb:v0E6Ap030C*
|
||||
ID_MODEL_FROM_DATABASE=Truly Ergonomic Computer Keyboard
|
||||
|
||||
usb:v0E6Ap6001*
|
||||
ID_MODEL_FROM_DATABASE=GEMBIRD Flexible keyboard KB-109F-B-DE
|
||||
|
||||
@ -39548,6 +39665,12 @@ usb:v1039p0824*
|
||||
usb:v1039p2140*
|
||||
ID_MODEL_FROM_DATABASE=dsl+ 1100 duo
|
||||
|
||||
usb:v103A*
|
||||
ID_VENDOR_FROM_DATABASE=PSA
|
||||
|
||||
usb:v103ApF000*
|
||||
ID_MODEL_FROM_DATABASE=Actia Evo XS
|
||||
|
||||
usb:v103D*
|
||||
ID_VENDOR_FROM_DATABASE=Stanton
|
||||
|
||||
@ -39692,6 +39815,9 @@ usb:v1050p0110*
|
||||
usb:v1050p0111*
|
||||
ID_MODEL_FROM_DATABASE=Yubikey NEO OTP+CCID
|
||||
|
||||
usb:v1050p0200*
|
||||
ID_MODEL_FROM_DATABASE=U2F Gnubby
|
||||
|
||||
usb:v1050p0211*
|
||||
ID_MODEL_FROM_DATABASE=Gnubby
|
||||
|
||||
@ -39735,16 +39861,25 @@ usb:v1058p0704*
|
||||
ID_MODEL_FROM_DATABASE=Passport External HDD
|
||||
|
||||
usb:v1058p070A*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Essential SE, My Passport for Mac (WDBAAB)
|
||||
ID_MODEL_FROM_DATABASE=My Passport Essential (WDBAAA), My Passport for Mac (WDBAAB), My Passport Essential SE (WDBABM), My Passport SE for Mac (WDBABW)
|
||||
|
||||
usb:v1058p070B*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Elite (WDBAAC)
|
||||
|
||||
usb:v1058p070C*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Studio (WDBAAE)
|
||||
|
||||
usb:v1058p071A*
|
||||
ID_MODEL_FROM_DATABASE=My Passport
|
||||
ID_MODEL_FROM_DATABASE=My Passport Essential (WDBAAA)
|
||||
|
||||
usb:v1058p071D*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Studio (WDBALG)
|
||||
|
||||
usb:v1058p0730*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Essential (WDBACY)
|
||||
|
||||
usb:v1058p0740*
|
||||
ID_MODEL_FROM_DATABASE=My Passport
|
||||
ID_MODEL_FROM_DATABASE=My Passport Essential (WDBACY)
|
||||
|
||||
usb:v1058p0741*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Ultra
|
||||
@ -39756,22 +39891,22 @@ usb:v1058p0748*
|
||||
ID_MODEL_FROM_DATABASE=My Passport (WDBKXH)
|
||||
|
||||
usb:v1058p0810*
|
||||
ID_MODEL_FROM_DATABASE=My Passport Ultra
|
||||
ID_MODEL_FROM_DATABASE=My Passport Ultra (WDBZFP)
|
||||
|
||||
usb:v1058p0900*
|
||||
ID_MODEL_FROM_DATABASE=MyBook Essential External HDD
|
||||
|
||||
usb:v1058p0901*
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential Edition (Green Ring)
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential Edition (Green Ring) (WDG1U)
|
||||
|
||||
usb:v1058p0902*
|
||||
ID_MODEL_FROM_DATABASE=My Book Pro Edition
|
||||
ID_MODEL_FROM_DATABASE=My Book Pro Edition (WDG1T)
|
||||
|
||||
usb:v1058p0903*
|
||||
ID_MODEL_FROM_DATABASE=My Book Premium Edition
|
||||
|
||||
usb:v1058p0910*
|
||||
ID_MODEL_FROM_DATABASE=MyBook Essential External HDD
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential Edition (Green Ring) (WDG1U)
|
||||
|
||||
usb:v1058p1001*
|
||||
ID_MODEL_FROM_DATABASE=Elements Desktop (WDE1U)
|
||||
@ -39786,7 +39921,7 @@ usb:v1058p1021*
|
||||
ID_MODEL_FROM_DATABASE=Elements Desktop (WDBAAU)
|
||||
|
||||
usb:v1058p1023*
|
||||
ID_MODEL_FROM_DATABASE=Elements SE
|
||||
ID_MODEL_FROM_DATABASE=Elements SE Portable (WDBABV)
|
||||
|
||||
usb:v1058p1048*
|
||||
ID_MODEL_FROM_DATABASE=Elements Portable (WDBU6Y)
|
||||
@ -39809,11 +39944,23 @@ usb:v1058p1104*
|
||||
usb:v1058p1105*
|
||||
ID_MODEL_FROM_DATABASE=My Book Studio II
|
||||
|
||||
usb:v1058p1110*
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential (WDBAAF), My Book for Mac (WDBAAG)
|
||||
|
||||
usb:v1058p1111*
|
||||
ID_MODEL_FROM_DATABASE=My Book Elite (WDBAAH)
|
||||
|
||||
usb:v1058p1112*
|
||||
ID_MODEL_FROM_DATABASE=My Book Studio (WDBAAJ), My Book Studio LX (WDBACH)
|
||||
|
||||
usb:v1058p1123*
|
||||
ID_MODEL_FROM_DATABASE=My Book 3.0
|
||||
ID_MODEL_FROM_DATABASE=My Book 3.0 (WDBABP)
|
||||
|
||||
usb:v1058p1130*
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential (WDBACW)
|
||||
|
||||
usb:v1058p1140*
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential USB3.0
|
||||
ID_MODEL_FROM_DATABASE=My Book Essential (WDBACW)
|
||||
|
||||
usb:v1059*
|
||||
ID_VENDOR_FROM_DATABASE=Giesecke & Devrient GmbH
|
||||
@ -42098,6 +42245,12 @@ usb:v132Bp2045*
|
||||
usb:v132Bp2049*
|
||||
ID_MODEL_FROM_DATABASE=Magicolor 2490MF
|
||||
|
||||
usb:v133E*
|
||||
ID_VENDOR_FROM_DATABASE=Kemper Digital GmbH
|
||||
|
||||
usb:v133Ep0815*
|
||||
ID_MODEL_FROM_DATABASE=Virus TI Desktop
|
||||
|
||||
usb:v1342*
|
||||
ID_VENDOR_FROM_DATABASE=Mobility
|
||||
|
||||
@ -42203,6 +42356,9 @@ usb:v134E*
|
||||
usb:v1357*
|
||||
ID_VENDOR_FROM_DATABASE=P&E Microcomputer Systems
|
||||
|
||||
usb:v1357p0089*
|
||||
ID_MODEL_FROM_DATABASE=OpenSDA - CDC Serial Port
|
||||
|
||||
usb:v1357p0503*
|
||||
ID_MODEL_FROM_DATABASE=USB-ML-12 HCS08/HCS12 Multilink
|
||||
|
||||
@ -42213,7 +42369,7 @@ usb:v1366*
|
||||
ID_VENDOR_FROM_DATABASE=SEGGER
|
||||
|
||||
usb:v1366p0101*
|
||||
ID_MODEL_FROM_DATABASE=J-Link ARM
|
||||
ID_MODEL_FROM_DATABASE=J-Link PLUS
|
||||
|
||||
usb:v136B*
|
||||
ID_VENDOR_FROM_DATABASE=STEC
|
||||
@ -42311,6 +42467,9 @@ usb:v138Ap003C*
|
||||
usb:v138Ap003D*
|
||||
ID_MODEL_FROM_DATABASE=VFS491
|
||||
|
||||
usb:v138Ap003F*
|
||||
ID_MODEL_FROM_DATABASE=VFS495 Fingerprint Reader
|
||||
|
||||
usb:v138Ap0050*
|
||||
ID_MODEL_FROM_DATABASE=Swipe Fingerprint Sensor
|
||||
|
||||
@ -42647,6 +42806,9 @@ usb:v13D3p5122*
|
||||
usb:v13D3p5126*
|
||||
ID_MODEL_FROM_DATABASE=PC Cam
|
||||
|
||||
usb:v13D3p5130*
|
||||
ID_MODEL_FROM_DATABASE=Integrated Webcam
|
||||
|
||||
usb:v13D3p5702*
|
||||
ID_MODEL_FROM_DATABASE=UVC VGA Webcam
|
||||
|
||||
@ -43232,6 +43394,9 @@ usb:v1493p0019*
|
||||
usb:v1493p001A*
|
||||
ID_MODEL_FROM_DATABASE=Colibri [Ambit2 S]
|
||||
|
||||
usb:v1493p001D*
|
||||
ID_MODEL_FROM_DATABASE=Greentit [Ambit2 R]
|
||||
|
||||
usb:v1497*
|
||||
ID_VENDOR_FROM_DATABASE=Panstrong Company Ltd.
|
||||
|
||||
@ -49640,12 +49805,39 @@ usb:v2478*
|
||||
usb:v2478p2008*
|
||||
ID_MODEL_FROM_DATABASE=U209-000-R Serial Port
|
||||
|
||||
usb:v249C*
|
||||
ID_VENDOR_FROM_DATABASE=M2Tech s.r.l.
|
||||
|
||||
usb:v2632*
|
||||
ID_VENDOR_FROM_DATABASE=TwinMOS
|
||||
|
||||
usb:v2632p3209*
|
||||
ID_MODEL_FROM_DATABASE=7-in-1 Card Reader
|
||||
|
||||
usb:v2639*
|
||||
ID_VENDOR_FROM_DATABASE=Xsens
|
||||
|
||||
usb:v2639p0001*
|
||||
ID_MODEL_FROM_DATABASE=MTi-10 IMU
|
||||
|
||||
usb:v2639p0002*
|
||||
ID_MODEL_FROM_DATABASE=MTi-20 VRU
|
||||
|
||||
usb:v2639p0003*
|
||||
ID_MODEL_FROM_DATABASE=MTi-30 AHRS
|
||||
|
||||
usb:v2639p0011*
|
||||
ID_MODEL_FROM_DATABASE=MTi-100 IMU
|
||||
|
||||
usb:v2639p0012*
|
||||
ID_MODEL_FROM_DATABASE=MTi-200 VRU
|
||||
|
||||
usb:v2639p0013*
|
||||
ID_MODEL_FROM_DATABASE=MTi-300 AHRS
|
||||
|
||||
usb:v2639p0017*
|
||||
ID_MODEL_FROM_DATABASE=MTi-G-700 GPS INS
|
||||
|
||||
usb:v2650*
|
||||
ID_VENDOR_FROM_DATABASE=Electronics For Imaging, Inc. [hex]
|
||||
|
||||
|
||||
@ -28,19 +28,33 @@
|
||||
# driver, <vendor> is the firmware-provided string exported
|
||||
# by the kernel DMI modalias.
|
||||
#
|
||||
# Scan codes are specified as:
|
||||
# KEYBOARD_KEY_<hex scan code>=<key code identifier>
|
||||
# The scan code should be expressed in hex lowercase and in
|
||||
# full bytes, a multiple of 2 digits. The key codes are retrieved
|
||||
# and normalized from the kernel input API header.
|
||||
# Scan codes are specified as:
|
||||
# KEYBOARD_KEY_<hex scan code>=<key code identifier>
|
||||
# The scan code should be expressed in hex lowercase. The key codes
|
||||
# are retrieved and normalized from the kernel input API header.
|
||||
#
|
||||
# A '!' as the first charcter of the key identifier string
|
||||
# will add the scan code to the AT keyboard's list of scan codes
|
||||
# where the driver will synthesize a release event and not expect
|
||||
# it to be generated by the hardware.
|
||||
# An '!' as the first character of the key identifier string
|
||||
# will add the scan code to the AT keyboard's list of scan codes
|
||||
# where the driver will synthesize a release event and not expect
|
||||
# it to be generated by the hardware.
|
||||
#
|
||||
# To debug key presses and access scan code mapping data of
|
||||
# an input device use the commonly available tool: evtest(1).
|
||||
#
|
||||
# To update this file, create a new file
|
||||
# /etc/udev/hwdb.d/70-keyboad.hwdb
|
||||
# and add your rules there. To load the new rules execute (as root):
|
||||
# udevadm hwdb --update
|
||||
# udevadm trigger /dev/input/eventXX
|
||||
# where /dev/input/eventXX is the keyboard in question. If in
|
||||
# doubt, simply use /dev/input/event* to reload all input rules.
|
||||
#
|
||||
# If your changes are generally applicable, open a bug report on
|
||||
# http://bugs.freedesktop.org/enter_bug.cgi?product=systemd
|
||||
# and include your new rules, a description of the device, and the
|
||||
# output of
|
||||
# udevadm info /dev/input/eventXX
|
||||
# (or /dev/input/event*).
|
||||
|
||||
##########################################
|
||||
# Acer
|
||||
@ -139,6 +153,7 @@ keyboard:dmi:bvn*:bvr*:bd*:svnASUS:pn*
|
||||
|
||||
keyboard:name:Asus WMI hotkeys:dmi:bvn*:bvr*:bd*:svnASUS*:pn*:pvr*
|
||||
keyboard:name:Eee PC WMI hotkeys:dmi:bvn*:bvr*:bd*:svnASUS*:pn*:pvr*
|
||||
keyboard:name:Asus Laptop extra buttons:dmi:bvn*:bvr*:bd*:svnASUS*:pn*:pvr*
|
||||
KEYBOARD_KEY_6b=f21 # Touchpad Toggle
|
||||
|
||||
###########################################################
|
||||
@ -166,6 +181,13 @@ keyboard:dmi:bvn*:bvr*:bd*:svnCompaq*:pn*Evo*N*:pvr*
|
||||
KEYBOARD_KEY_9e=email
|
||||
KEYBOARD_KEY_9f=homepage
|
||||
|
||||
keyboard:usb:v049Fp0051d*dc*dsc*dp*ic*isc*ip*in01*
|
||||
KEYBOARD_KEY_0c0011=presentation
|
||||
KEYBOARD_KEY_0c0012=addressbook
|
||||
KEYBOARD_KEY_0c0013=info
|
||||
KEYBOARD_KEY_0c0014=prog1
|
||||
KEYBOARD_KEY_0c0015=messenger
|
||||
|
||||
###########################################################
|
||||
# Dell
|
||||
###########################################################
|
||||
@ -229,6 +251,15 @@ keyboard:dmi:bvn*:bvr*:bd*:svnDell*:pnPrecision*:pvr*
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svnDell*:pnXPS*:pvr*
|
||||
KEYBOARD_KEY_8c=!unknown
|
||||
|
||||
# Dell XPS12 9Q33
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svnDell*:pnXPS12-9Q33*:pvr*
|
||||
KEYBOARD_KEY_88=wlan
|
||||
KEYBOARD_KEY_65=switchvideomode # Screen Rotate
|
||||
|
||||
# Dell Latitude microphone mute
|
||||
keyboard:name:Dell WMI hotkeys:dmi:bvn*:bvr*:bd*:svnDell*:pnLatitude*
|
||||
KEYBOARD_KEY_150=f20 # Mic mute toggle, should be micmute
|
||||
|
||||
###########################################################
|
||||
# Everex
|
||||
###########################################################
|
||||
@ -364,7 +395,7 @@ keyboard:dmi:bvn*:bvr*:bd*:svnHewlett-Packard*:pnHP*Pavilion*dv7*Notebook*PC:pvr
|
||||
KEYBOARD_KEY_b7=print
|
||||
KEYBOARD_KEY_c2=media # FIXME: quick play
|
||||
KEYBOARD_KEY_c6=break
|
||||
KEYBOARD_KEY_94=0
|
||||
KEYBOARD_KEY_94=reserved
|
||||
|
||||
# Elitebook
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svnHewlett-Packard*:pn*Compaq*:pvr*
|
||||
@ -501,7 +532,7 @@ keyboard:name:ThinkPad Extra Buttons:dmi:bvn*:bvr*:bd*:svnLENOVO*:pn*
|
||||
KEYBOARD_KEY_15=volumedown
|
||||
KEYBOARD_KEY_16=mute
|
||||
KEYBOARD_KEY_17=prog1
|
||||
KEYBOARD_KEY_1a=f20
|
||||
KEYBOARD_KEY_1a=f20 # Microphone mute button; should be micmute
|
||||
|
||||
# ThinkPad Keyboard with TrackPoint
|
||||
keyboard:usb:v17EFp6009*
|
||||
@ -569,7 +600,7 @@ keyboard:dmi:bvn*:bvr*:bd*:svnLENOVO*:pn*IdeaPad*Y550*:pvr*
|
||||
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svnLENOVO*:pn*IdeaPad*U300s*:pvr*
|
||||
KEYBOARD_KEY_f1=f21
|
||||
KEYBOARD_KEY_ce=f20
|
||||
KEYBOARD_KEY_ce=f20 # micmute
|
||||
|
||||
keyboard:dmi:bvn*:bvr*:svnLENOVO*:pn*IdeaPad*Z370*:pvr*
|
||||
KEYBOARD_KEY_a0=!mute
|
||||
@ -805,7 +836,7 @@ keyboard:dmi:bvn*:bvr*:bd*:svnOLPC:pnXO:*
|
||||
KEYBOARD_KEY_f3=f17
|
||||
KEYBOARD_KEY_f2=f18
|
||||
KEYBOARD_KEY_f1=f19
|
||||
KEYBOARD_KEY_f0=f20
|
||||
KEYBOARD_KEY_f0=f20 # micmute
|
||||
KEYBOARD_KEY_ef=f21
|
||||
KEYBOARD_KEY_ee=chat
|
||||
KEYBOARD_KEY_e4=chat
|
||||
@ -921,7 +952,7 @@ keyboard:dmi:bvn*:bvr*:bd*:svn[sS][aA][mM][sS][uU][nN][gG]*:pn*550P*:pvr*
|
||||
# Series 7 / 9
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svn[sS][aA][mM][sS][uU][nN][gG]*:pn*700Z*:pvr*
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svn[sS][aA][mM][sS][uU][nN][gG]*:pn*700G*:pvr*
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svn[sS][aA][mM][sS][uU][nN][gG]*:pn*900X[34][CDEFG]*:pvr*
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svn[sS][aA][mM][sS][uU][nN][gG]*:pn*900X[34]*:pvr*
|
||||
keyboard:dmi:bvn*:bvr*:bd*:svn[sS][aA][mM][sS][uU][nN][gG]*:pn*940X3G*:pvr*
|
||||
KEYBOARD_KEY_ce=!prog1 # Fn+F1 launch settings
|
||||
KEYBOARD_KEY_a0=!mute # Fn+F6 mute
|
||||
@ -1071,7 +1102,7 @@ keyboard:name:Toshiba*input*device:dmi:bvn*:bvr*:bd*:svnTOSHIBA*:pnSatellite*P75
|
||||
KEYBOARD_KEY_13c=brightnessdown
|
||||
KEYBOARD_KEY_13d=brightnessup
|
||||
KEYBOARD_KEY_13e=switchvideomode
|
||||
KEYBOARD_KEY_13f=touchpad_toggle
|
||||
KEYBOARD_KEY_13f=f21 # Touchpad toggle
|
||||
KEYBOARD_KEY_9e=wlan
|
||||
|
||||
###########################################################
|
||||
|
||||
@ -42,7 +42,7 @@ AC_DEFUN([CC_CHECK_FLAG_APPEND], [
|
||||
AS_TR_SH([cc_cv_$2_$3]),
|
||||
[eval "AS_TR_SH([cc_save_$2])='${$2}'"
|
||||
eval "AS_TR_SH([$2])='-Werror $3'"
|
||||
AC_LINK_IFELSE([AC_LANG_SOURCE([int a = 0; int main(void) { return a; } ])],
|
||||
AC_LINK_IFELSE([AC_LANG_SOURCE([int main(void) { return 0; } ])],
|
||||
[eval "AS_TR_SH([cc_cv_$2_$3])='yes'"],
|
||||
[eval "AS_TR_SH([cc_cv_$2_$3])='no'"])
|
||||
eval "AS_TR_SH([$2])='$cc_save_$2'"])
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214191197712"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214182199552"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
process and generate 128-bit ID values. The 128-bit ID
|
||||
values processed and generated by these APIs are a
|
||||
generalization of OSF UUIDs as defined by <a class="ulink" href="https://tools.ietf.org/html/rfc4122" target="_top">RFC
|
||||
@ -55,7 +55,7 @@
|
||||
}</pre><p><code class="function">SD_ID128_FORMAT_STR</code> and
|
||||
<code class="function">SD_ID128_FORMAT_VAL()</code> may be used
|
||||
to format a 128-bit ID in a
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
format string, as shown in the following
|
||||
example:</p><pre class="programlisting">int main(int argc, char *argv[]) {
|
||||
sd_id128_t id;
|
||||
@ -73,17 +73,17 @@
|
||||
}</pre><p>Note that new, randomized IDs may be generated
|
||||
with
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>'s
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214187744304"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214179846512"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214191643840"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214186132384"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_id128_to_string.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_to_string</span>(3)</span></a>,
|
||||
<a href="sd_id128_randomize.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_randomize</span>(3)</span></a>,
|
||||
<a href="sd_id128_get_machine.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_get_machine</span>(3)</span></a>,
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(7)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214191197712"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214182199552"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
process and generate 128-bit ID values. The 128-bit ID
|
||||
values processed and generated by these APIs are a
|
||||
generalization of OSF UUIDs as defined by <a class="ulink" href="https://tools.ietf.org/html/rfc4122" target="_top">RFC
|
||||
@ -55,7 +55,7 @@
|
||||
}</pre><p><code class="function">SD_ID128_FORMAT_STR</code> and
|
||||
<code class="function">SD_ID128_FORMAT_VAL()</code> may be used
|
||||
to format a 128-bit ID in a
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
format string, as shown in the following
|
||||
example:</p><pre class="programlisting">int main(int argc, char *argv[]) {
|
||||
sd_id128_t id;
|
||||
@ -73,17 +73,17 @@
|
||||
}</pre><p>Note that new, randomized IDs may be generated
|
||||
with
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>'s
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214187744304"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214179846512"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214191643840"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214186132384"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_id128_to_string.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_to_string</span>(3)</span></a>,
|
||||
<a href="sd_id128_randomize.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_randomize</span>(3)</span></a>,
|
||||
<a href="sd_id128_get_machine.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_get_machine</span>(3)</span></a>,
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(7)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214191197712"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214182199552"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
process and generate 128-bit ID values. The 128-bit ID
|
||||
values processed and generated by these APIs are a
|
||||
generalization of OSF UUIDs as defined by <a class="ulink" href="https://tools.ietf.org/html/rfc4122" target="_top">RFC
|
||||
@ -55,7 +55,7 @@
|
||||
}</pre><p><code class="function">SD_ID128_FORMAT_STR</code> and
|
||||
<code class="function">SD_ID128_FORMAT_VAL()</code> may be used
|
||||
to format a 128-bit ID in a
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
format string, as shown in the following
|
||||
example:</p><pre class="programlisting">int main(int argc, char *argv[]) {
|
||||
sd_id128_t id;
|
||||
@ -73,17 +73,17 @@
|
||||
}</pre><p>Note that new, randomized IDs may be generated
|
||||
with
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>'s
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214187744304"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214179846512"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214191643840"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214186132384"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_id128_to_string.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_to_string</span>(3)</span></a>,
|
||||
<a href="sd_id128_randomize.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_randomize</span>(3)</span></a>,
|
||||
<a href="sd_id128_get_machine.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_get_machine</span>(3)</span></a>,
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(7)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214191197712"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-id128"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-id128, sd_id128_t, SD_ID128_MAKE, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL, sd_id128_equal — APIs for processing 128-bit IDs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-id128.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214182199552"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-id128.h</code> provides APIs to
|
||||
process and generate 128-bit ID values. The 128-bit ID
|
||||
values processed and generated by these APIs are a
|
||||
generalization of OSF UUIDs as defined by <a class="ulink" href="https://tools.ietf.org/html/rfc4122" target="_top">RFC
|
||||
@ -55,7 +55,7 @@
|
||||
}</pre><p><code class="function">SD_ID128_FORMAT_STR</code> and
|
||||
<code class="function">SD_ID128_FORMAT_VAL()</code> may be used
|
||||
to format a 128-bit ID in a
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
format string, as shown in the following
|
||||
example:</p><pre class="programlisting">int main(int argc, char *argv[]) {
|
||||
sd_id128_t id;
|
||||
@ -73,17 +73,17 @@
|
||||
}</pre><p>Note that new, randomized IDs may be generated
|
||||
with
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>'s
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214187744304"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
<code class="option">--new-id</code> option.</p></div><div class="refsect1"><a name="idm214179846512"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214191643840"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214186132384"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_id128_to_string.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_to_string</span>(3)</span></a>,
|
||||
<a href="sd_id128_randomize.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_randomize</span>(3)</span></a>,
|
||||
<a href="sd_id128_get_machine.html"><span class="citerefentry"><span class="refentrytitle">sd_id128_get_machine</span>(3)</span></a>,
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>,
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(7)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,15 +19,15 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_get_fd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_fd, sd_journal_get_events, sd_journal_get_timeout, sd_journal_process, sd_journal_wait, sd_journal_reliable_fd, SD_JOURNAL_NOP, SD_JOURNAL_APPEND, SD_JOURNAL_INVALIDATE — Journal change notification
|
||||
interface</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_events</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_timeout</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t *<var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_process</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_wait</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_reliable_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214185830672"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_get_fd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_fd, sd_journal_get_events, sd_journal_get_timeout, sd_journal_process, sd_journal_wait, sd_journal_reliable_fd, SD_JOURNAL_NOP, SD_JOURNAL_APPEND, SD_JOURNAL_INVALIDATE — Journal change notification
|
||||
interface</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_events</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_timeout</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t *<var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_process</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_wait</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_reliable_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214177185680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
a file descriptor that may be asynchronously polled in
|
||||
an external event loop and is signaled as soon as the
|
||||
journal changes, because new entries or files were
|
||||
added, rotation took place, or files have been
|
||||
deleted, and similar. The file descriptor is suitable
|
||||
for usage in
|
||||
<a href="poll.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>. Use
|
||||
<a href="http://man7.org/linux/man-pages/man2/poll.2.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>. Use
|
||||
<code class="function">sd_journal_get_events()</code> for an
|
||||
events mask to watch for. The call takes one argument:
|
||||
the journal context object. Note that not all file
|
||||
@ -53,7 +53,7 @@
|
||||
<code class="constant">CLOCK_MONOTONIC</code> for timing out
|
||||
<code class="function">poll()</code> in
|
||||
<code class="varname">timeout_usec</code>. See
|
||||
<a href="clock_gettime.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/clock_gettime.2.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
for details about
|
||||
<code class="constant">CLOCK_MONOTONIC</code>. If there is no
|
||||
timeout to wait for, this will fill in
|
||||
@ -112,7 +112,7 @@ else {
|
||||
no need to invoke this function directly as
|
||||
<code class="function">sd_journal_get_timeout()</code> on these
|
||||
file systems will ask for timeouts explicitly
|
||||
anyway.</p></div><div class="refsect1"><a name="idm214185790416"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
anyway.</p></div><div class="refsect1"><a name="idm214177145424"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
a valid file descriptor on success or a negative
|
||||
errno-style error code.</p><p><code class="function">sd_journal_get_events()</code>
|
||||
returns a combination of <code class="constant">POLLIN</code>,
|
||||
@ -138,15 +138,15 @@ else {
|
||||
probably refresh their entire display, while in the
|
||||
case of <code class="constant">SD_JOURNAL_APPEND</code>, it is
|
||||
sufficient to simply continue reading at the previous
|
||||
end of the journal.</p></div><div class="refsect1"><a name="idm214180864000"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_fd()</code>,
|
||||
end of the journal.</p></div><div class="refsect1"><a name="idm214172223728"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_fd()</code>,
|
||||
<code class="function">sd_journal_get_events()</code>,
|
||||
<code class="function">sd_journal_reliable_fd()</code>,
|
||||
<code class="function">sd_journal_process()</code> and
|
||||
<code class="function">sd_journal_wait()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214180858416"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal, in a live view tracking all changes:</p><pre class="programlisting">#include <stdio.h>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214172217904"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal, in a live view tracking all changes:</p><pre class="programlisting">#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include <systemd/sd-journal.h>
|
||||
|
||||
@ -208,11 +208,11 @@ int wait_for_changes(sd_journal *j) {
|
||||
pollfd.events = sd_journal_get_events(j);
|
||||
poll(&pollfd, 1, msec);
|
||||
return sd_journal_process(j);
|
||||
}</pre></div><div class="refsect1"><a name="idm214180851792"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
}</pre></div><div class="refsect1"><a name="idm214172211280"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_open.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_open</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
<a href="poll.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>,
|
||||
<a href="clock_gettime.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/poll.2.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man2/clock_gettime.2.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214202620928"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214171075312"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
the log journal for reading. It will find all journal
|
||||
files automatically and interleave them automatically
|
||||
when reading. As first argument it takes a pointer to
|
||||
@ -95,18 +95,18 @@
|
||||
locally, to its closest entry in time)
|
||||
<a href="sd_journal_seek_cursor.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_seek_cursor</span>(3)</span></a>.</p><p>Notification of journal changes is available via
|
||||
<code class="function">sd_journal_get_fd()</code> and related
|
||||
calls.</p></div><div class="refsect1"><a name="idm214202586464"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
calls.</p></div><div class="refsect1"><a name="idm214171040560"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code>, and
|
||||
<code class="function">sd_journal_open_files()</code> calls
|
||||
return 0 on success or a negative errno-style error
|
||||
code. <code class="function">sd_journal_close()</code> returns
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214202582256"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214171036352"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code> and
|
||||
<code class="function">sd_journal_close()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197661808"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214166120416"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_close()</code>,
|
||||
<code class="constant">SD_JOURNAL_LOCAL_ONLY</code>,
|
||||
<code class="constant">SD_JOURNAL_RUNTIME_ONLY</code>,
|
||||
@ -117,7 +117,7 @@
|
||||
and <code class="function">sd_journal_open_files()</code>
|
||||
were added in systemd-205.
|
||||
<code class="constant">SD_JOURNAL_SYSTEM_ONLY</code>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214197655472"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214166114080"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_next"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_next, sd_journal_previous, sd_journal_next_skip, sd_journal_previous_skip, SD_JOURNAL_FOREACH, SD_JOURNAL_FOREACH_BACKWARDS — Advance or set back the read pointer in the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_BACKWARDS</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214197612176"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_next()</code> advances
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_next"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_next, sd_journal_previous, sd_journal_next_skip, sd_journal_previous_skip, SD_JOURNAL_FOREACH, SD_JOURNAL_FOREACH_BACKWARDS — Advance or set back the read pointer in the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_BACKWARDS</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214186673504"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_next()</code> advances
|
||||
the read pointer into the journal by one entry. The
|
||||
only argument taken is a journal context object as
|
||||
allocated via
|
||||
@ -48,7 +48,7 @@
|
||||
for an example. Similarly,
|
||||
<code class="function">SD_JOURNAL_FOREACH_BACKWARDS()</code>
|
||||
may be used for iterating the journal in reverse
|
||||
order.</p></div><div class="refsect1"><a name="idm214197598784"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The four calls return the number of entries
|
||||
order.</p></div><div class="refsect1"><a name="idm214186660112"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The four calls return the number of entries
|
||||
advanced/set back on success or a negative errno-style
|
||||
error code. When the end or beginning of the journal
|
||||
is reached, a number smaller than requested is
|
||||
@ -57,13 +57,13 @@
|
||||
<code class="function">sd_journal_previous()</code> reach the
|
||||
end/beginning of the journal they will return 0,
|
||||
instead of 1 when they are successful. This should be
|
||||
considered an EOF marker.</p></div><div class="refsect1"><a name="idm214197588368"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_next()</code>, <code class="function">sd_journal_previous()</code>,
|
||||
considered an EOF marker.</p></div><div class="refsect1"><a name="idm214186649728"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_next()</code>, <code class="function">sd_journal_previous()</code>,
|
||||
<code class="function">sd_journal_next_skip()</code> and
|
||||
<code class="function">sd_journal_previous_skip()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197582832"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal:</p><pre class="programlisting">#include <stdio.h>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214186643872"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal:</p><pre class="programlisting">#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include <systemd/sd-journal.h>
|
||||
|
||||
@ -89,7 +89,7 @@ int main(int argc, char *argv[]) {
|
||||
}
|
||||
sd_journal_close(j);
|
||||
return 0;
|
||||
}</pre></div><div class="refsect1"><a name="idm214197579328"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
}</pre></div><div class="refsect1"><a name="idm214186640368"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_open.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_open</span>(3)</span></a>,
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_next"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_next, sd_journal_previous, sd_journal_next_skip, sd_journal_previous_skip, SD_JOURNAL_FOREACH, SD_JOURNAL_FOREACH_BACKWARDS — Advance or set back the read pointer in the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_BACKWARDS</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214197612176"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_next()</code> advances
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_next"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_next, sd_journal_previous, sd_journal_next_skip, sd_journal_previous_skip, SD_JOURNAL_FOREACH, SD_JOURNAL_FOREACH_BACKWARDS — Advance or set back the read pointer in the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_next_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_previous_skip</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">skip</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_BACKWARDS</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214186673504"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_next()</code> advances
|
||||
the read pointer into the journal by one entry. The
|
||||
only argument taken is a journal context object as
|
||||
allocated via
|
||||
@ -48,7 +48,7 @@
|
||||
for an example. Similarly,
|
||||
<code class="function">SD_JOURNAL_FOREACH_BACKWARDS()</code>
|
||||
may be used for iterating the journal in reverse
|
||||
order.</p></div><div class="refsect1"><a name="idm214197598784"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The four calls return the number of entries
|
||||
order.</p></div><div class="refsect1"><a name="idm214186660112"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The four calls return the number of entries
|
||||
advanced/set back on success or a negative errno-style
|
||||
error code. When the end or beginning of the journal
|
||||
is reached, a number smaller than requested is
|
||||
@ -57,13 +57,13 @@
|
||||
<code class="function">sd_journal_previous()</code> reach the
|
||||
end/beginning of the journal they will return 0,
|
||||
instead of 1 when they are successful. This should be
|
||||
considered an EOF marker.</p></div><div class="refsect1"><a name="idm214197588368"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_next()</code>, <code class="function">sd_journal_previous()</code>,
|
||||
considered an EOF marker.</p></div><div class="refsect1"><a name="idm214186649728"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_next()</code>, <code class="function">sd_journal_previous()</code>,
|
||||
<code class="function">sd_journal_next_skip()</code> and
|
||||
<code class="function">sd_journal_previous_skip()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197582832"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal:</p><pre class="programlisting">#include <stdio.h>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214186643872"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal:</p><pre class="programlisting">#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include <systemd/sd-journal.h>
|
||||
|
||||
@ -89,7 +89,7 @@ int main(int argc, char *argv[]) {
|
||||
}
|
||||
sd_journal_close(j);
|
||||
return 0;
|
||||
}</pre></div><div class="refsect1"><a name="idm214197579328"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
}</pre></div><div class="refsect1"><a name="idm214186640368"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_open.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_open</span>(3)</span></a>,
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_get_data"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_data, sd_journal_enumerate_data, sd_journal_restart_data, SD_JOURNAL_FOREACH_DATA, sd_journal_set_data_threshold, sd_journal_get_data_threshold — Read data fields from the current journal entry</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_data</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">field</var>, </td></tr><tr><td> </td><td>const void **<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_enumerate_data</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void **<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_restart_data</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_DATA</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void *<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_set_data_threshold</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">sz</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_data_threshold</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">sz</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214182872080"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_data()</code> gets
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_get_data"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_data, sd_journal_enumerate_data, sd_journal_restart_data, SD_JOURNAL_FOREACH_DATA, sd_journal_set_data_threshold, sd_journal_get_data_threshold — Read data fields from the current journal entry</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_data</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">field</var>, </td></tr><tr><td> </td><td>const void **<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_enumerate_data</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void **<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_restart_data</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_DATA</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void *<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_set_data_threshold</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">sz</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_data_threshold</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">sz</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214173981200"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_data()</code> gets
|
||||
the data object associated with a specific field from
|
||||
the current journal entry. It takes four arguments:
|
||||
the journal context object, a string with the field
|
||||
@ -77,7 +77,7 @@
|
||||
having to decompress large compressed data objects in
|
||||
full.</p><p><code class="function">sd_journal_get_data_threshold()</code>
|
||||
returns the currently configured data field size
|
||||
threshold.</p></div><div class="refsect1"><a name="idm214182845904"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_data()</code>
|
||||
threshold.</p></div><div class="refsect1"><a name="idm214173955088"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_data()</code>
|
||||
returns 0 on success or a negative errno-style error
|
||||
code. If the current entry does not include the
|
||||
specified field, -ENOENT is returned. If
|
||||
@ -92,7 +92,7 @@
|
||||
nothing. <code class="function">sd_journal_set_data_threshold()</code>
|
||||
and <code class="function">sd_journal_get_threshold()</code>
|
||||
return 0 on success or a negative errno-style error
|
||||
code.</p></div><div class="refsect1"><a name="idm214182839856"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_data()</code>,
|
||||
code.</p></div><div class="refsect1"><a name="idm214173949040"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_data()</code>,
|
||||
<code class="function">sd_journal_enumerate_data()</code>,
|
||||
<code class="function">sd_journal_restart_data()</code>,
|
||||
<code class="function">sd_journal_set_data_threshold()</code>
|
||||
@ -100,8 +100,8 @@
|
||||
<code class="function">sd_journal_get_data_threshold()</code>
|
||||
interfaces are available as a shared library, which can
|
||||
be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214177917392"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>See
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214169030976"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>See
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>
|
||||
for a complete example how to use
|
||||
<code class="function">sd_journal_get_data()</code>.</p><p>Use the
|
||||
@ -114,7 +114,7 @@ int print_fields(sd_journal *j) {
|
||||
SD_JOURNAL_FOREACH_DATA(j, data, length)
|
||||
printf("%.*s\n", (int) length, data);
|
||||
}
|
||||
...</pre></div><div class="refsect1"><a name="idm214177912896"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
...</pre></div><div class="refsect1"><a name="idm214169026480"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemd.journal-fields.html"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_query_unique"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_query_unique, sd_journal_enumerate_unique, sd_journal_restart_unique, SD_JOURNAL_FOREACH_UNIQUE — Read unique data fields from the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_query_unique</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">field</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_enumerate_unique</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void **<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_restart_unique</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_UNIQUE</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void *<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214197431712"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_query_unique()</code>
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_query_unique"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_query_unique, sd_journal_enumerate_unique, sd_journal_restart_unique, SD_JOURNAL_FOREACH_UNIQUE — Read unique data fields from the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_query_unique</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">field</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_enumerate_unique</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void **<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t *<var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_restart_unique</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef"><b class="fsfunc">SD_JOURNAL_FOREACH_UNIQUE</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>const void *<var class="pdparam">data</var>, </td></tr><tr><td> </td><td>size_t <var class="pdparam">length</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214178362992"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_query_unique()</code>
|
||||
queries the journal for all unique values the
|
||||
specified field can take. It takes two arguments: the
|
||||
journal to query and the field name to look
|
||||
@ -60,20 +60,20 @@
|
||||
influenced by matches set with
|
||||
<code class="function">sd_journal_add_match()</code> but this
|
||||
might change in a later version of this
|
||||
software.</p></div><div class="refsect1"><a name="idm214197493904"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_query_unique()</code>
|
||||
software.</p></div><div class="refsect1"><a name="idm214178349152"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_query_unique()</code>
|
||||
returns 0 on success or a negative errno-style error
|
||||
code. <code class="function">sd_journal_enumerate_unique()</code>
|
||||
returns a positive integer if the next field data has
|
||||
been read, 0 when no more fields are known, or a
|
||||
negative errno-style error
|
||||
code. <code class="function">sd_journal_restart_unique()</code>
|
||||
returns nothing.</p></div><div class="refsect1"><a name="idm214197490352"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_query_unique()</code>,
|
||||
returns nothing.</p></div><div class="refsect1"><a name="idm214178338080"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_query_unique()</code>,
|
||||
<code class="function">sd_journal_enumerate_unique()</code> and
|
||||
<code class="function">sd_journal_restart_unique()</code>
|
||||
interfaces are available as a shared library, which can
|
||||
be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197485472"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Use the
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214178332928"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Use the
|
||||
<code class="function">SD_JOURNAL_FOREACH_UNIQUE</code> macro
|
||||
to iterate through all values a field of the journal
|
||||
can take. The following example lists all unit names
|
||||
@ -101,7 +101,7 @@ int main(int argc, char *argv[]) {
|
||||
printf("%.*s\n", (int) l, (const char*) d);
|
||||
sd_journal_close(j);
|
||||
return 0;
|
||||
}</pre></div><div class="refsect1"><a name="idm214197482672"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
}</pre></div><div class="refsect1"><a name="idm214178328448"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemd.journal-fields.html"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
|
||||
@ -19,15 +19,15 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_get_fd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_fd, sd_journal_get_events, sd_journal_get_timeout, sd_journal_process, sd_journal_wait, sd_journal_reliable_fd, SD_JOURNAL_NOP, SD_JOURNAL_APPEND, SD_JOURNAL_INVALIDATE — Journal change notification
|
||||
interface</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_events</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_timeout</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t *<var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_process</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_wait</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_reliable_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214185830672"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_get_fd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_fd, sd_journal_get_events, sd_journal_get_timeout, sd_journal_process, sd_journal_wait, sd_journal_reliable_fd, SD_JOURNAL_NOP, SD_JOURNAL_APPEND, SD_JOURNAL_INVALIDATE — Journal change notification
|
||||
interface</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_events</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_timeout</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t *<var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_process</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_wait</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_reliable_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214177185680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
a file descriptor that may be asynchronously polled in
|
||||
an external event loop and is signaled as soon as the
|
||||
journal changes, because new entries or files were
|
||||
added, rotation took place, or files have been
|
||||
deleted, and similar. The file descriptor is suitable
|
||||
for usage in
|
||||
<a href="poll.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>. Use
|
||||
<a href="http://man7.org/linux/man-pages/man2/poll.2.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>. Use
|
||||
<code class="function">sd_journal_get_events()</code> for an
|
||||
events mask to watch for. The call takes one argument:
|
||||
the journal context object. Note that not all file
|
||||
@ -53,7 +53,7 @@
|
||||
<code class="constant">CLOCK_MONOTONIC</code> for timing out
|
||||
<code class="function">poll()</code> in
|
||||
<code class="varname">timeout_usec</code>. See
|
||||
<a href="clock_gettime.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/clock_gettime.2.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
for details about
|
||||
<code class="constant">CLOCK_MONOTONIC</code>. If there is no
|
||||
timeout to wait for, this will fill in
|
||||
@ -112,7 +112,7 @@ else {
|
||||
no need to invoke this function directly as
|
||||
<code class="function">sd_journal_get_timeout()</code> on these
|
||||
file systems will ask for timeouts explicitly
|
||||
anyway.</p></div><div class="refsect1"><a name="idm214185790416"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
anyway.</p></div><div class="refsect1"><a name="idm214177145424"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
a valid file descriptor on success or a negative
|
||||
errno-style error code.</p><p><code class="function">sd_journal_get_events()</code>
|
||||
returns a combination of <code class="constant">POLLIN</code>,
|
||||
@ -138,15 +138,15 @@ else {
|
||||
probably refresh their entire display, while in the
|
||||
case of <code class="constant">SD_JOURNAL_APPEND</code>, it is
|
||||
sufficient to simply continue reading at the previous
|
||||
end of the journal.</p></div><div class="refsect1"><a name="idm214180864000"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_fd()</code>,
|
||||
end of the journal.</p></div><div class="refsect1"><a name="idm214172223728"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_fd()</code>,
|
||||
<code class="function">sd_journal_get_events()</code>,
|
||||
<code class="function">sd_journal_reliable_fd()</code>,
|
||||
<code class="function">sd_journal_process()</code> and
|
||||
<code class="function">sd_journal_wait()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214180858416"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal, in a live view tracking all changes:</p><pre class="programlisting">#include <stdio.h>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214172217904"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal, in a live view tracking all changes:</p><pre class="programlisting">#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include <systemd/sd-journal.h>
|
||||
|
||||
@ -208,11 +208,11 @@ int wait_for_changes(sd_journal *j) {
|
||||
pollfd.events = sd_journal_get_events(j);
|
||||
poll(&pollfd, 1, msec);
|
||||
return sd_journal_process(j);
|
||||
}</pre></div><div class="refsect1"><a name="idm214180851792"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
}</pre></div><div class="refsect1"><a name="idm214172211280"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_open.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_open</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
<a href="poll.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>,
|
||||
<a href="clock_gettime.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/poll.2.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man2/clock_gettime.2.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214202620928"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214171075312"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
the log journal for reading. It will find all journal
|
||||
files automatically and interleave them automatically
|
||||
when reading. As first argument it takes a pointer to
|
||||
@ -95,18 +95,18 @@
|
||||
locally, to its closest entry in time)
|
||||
<a href="sd_journal_seek_cursor.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_seek_cursor</span>(3)</span></a>.</p><p>Notification of journal changes is available via
|
||||
<code class="function">sd_journal_get_fd()</code> and related
|
||||
calls.</p></div><div class="refsect1"><a name="idm214202586464"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
calls.</p></div><div class="refsect1"><a name="idm214171040560"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code>, and
|
||||
<code class="function">sd_journal_open_files()</code> calls
|
||||
return 0 on success or a negative errno-style error
|
||||
code. <code class="function">sd_journal_close()</code> returns
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214202582256"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214171036352"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code> and
|
||||
<code class="function">sd_journal_close()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197661808"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214166120416"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_close()</code>,
|
||||
<code class="constant">SD_JOURNAL_LOCAL_ONLY</code>,
|
||||
<code class="constant">SD_JOURNAL_RUNTIME_ONLY</code>,
|
||||
@ -117,7 +117,7 @@
|
||||
and <code class="function">sd_journal_open_files()</code>
|
||||
were added in systemd-205.
|
||||
<code class="constant">SD_JOURNAL_SYSTEM_ONLY</code>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214197655472"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214166114080"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
|
||||
@ -19,15 +19,15 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_get_fd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_fd, sd_journal_get_events, sd_journal_get_timeout, sd_journal_process, sd_journal_wait, sd_journal_reliable_fd, SD_JOURNAL_NOP, SD_JOURNAL_APPEND, SD_JOURNAL_INVALIDATE — Journal change notification
|
||||
interface</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_events</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_timeout</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t *<var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_process</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_wait</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_reliable_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214185830672"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_get_fd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_get_fd, sd_journal_get_events, sd_journal_get_timeout, sd_journal_process, sd_journal_wait, sd_journal_reliable_fd, SD_JOURNAL_NOP, SD_JOURNAL_APPEND, SD_JOURNAL_INVALIDATE — Journal change notification
|
||||
interface</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_events</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_get_timeout</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t *<var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_process</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_wait</b>(</code></td><td>sd_journal *<var class="pdparam">j</var>, </td></tr><tr><td> </td><td>uint64_t <var class="pdparam">timeout_usec</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_reliable_fd</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214177185680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
a file descriptor that may be asynchronously polled in
|
||||
an external event loop and is signaled as soon as the
|
||||
journal changes, because new entries or files were
|
||||
added, rotation took place, or files have been
|
||||
deleted, and similar. The file descriptor is suitable
|
||||
for usage in
|
||||
<a href="poll.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>. Use
|
||||
<a href="http://man7.org/linux/man-pages/man2/poll.2.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>. Use
|
||||
<code class="function">sd_journal_get_events()</code> for an
|
||||
events mask to watch for. The call takes one argument:
|
||||
the journal context object. Note that not all file
|
||||
@ -53,7 +53,7 @@
|
||||
<code class="constant">CLOCK_MONOTONIC</code> for timing out
|
||||
<code class="function">poll()</code> in
|
||||
<code class="varname">timeout_usec</code>. See
|
||||
<a href="clock_gettime.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/clock_gettime.2.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
for details about
|
||||
<code class="constant">CLOCK_MONOTONIC</code>. If there is no
|
||||
timeout to wait for, this will fill in
|
||||
@ -112,7 +112,7 @@ else {
|
||||
no need to invoke this function directly as
|
||||
<code class="function">sd_journal_get_timeout()</code> on these
|
||||
file systems will ask for timeouts explicitly
|
||||
anyway.</p></div><div class="refsect1"><a name="idm214185790416"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
anyway.</p></div><div class="refsect1"><a name="idm214177145424"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p><code class="function">sd_journal_get_fd()</code> returns
|
||||
a valid file descriptor on success or a negative
|
||||
errno-style error code.</p><p><code class="function">sd_journal_get_events()</code>
|
||||
returns a combination of <code class="constant">POLLIN</code>,
|
||||
@ -138,15 +138,15 @@ else {
|
||||
probably refresh their entire display, while in the
|
||||
case of <code class="constant">SD_JOURNAL_APPEND</code>, it is
|
||||
sufficient to simply continue reading at the previous
|
||||
end of the journal.</p></div><div class="refsect1"><a name="idm214180864000"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_fd()</code>,
|
||||
end of the journal.</p></div><div class="refsect1"><a name="idm214172223728"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_get_fd()</code>,
|
||||
<code class="function">sd_journal_get_events()</code>,
|
||||
<code class="function">sd_journal_reliable_fd()</code>,
|
||||
<code class="function">sd_journal_process()</code> and
|
||||
<code class="function">sd_journal_wait()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214180858416"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal, in a live view tracking all changes:</p><pre class="programlisting">#include <stdio.h>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214172217904"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Iterating through the journal, in a live view tracking all changes:</p><pre class="programlisting">#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include <systemd/sd-journal.h>
|
||||
|
||||
@ -208,11 +208,11 @@ int wait_for_changes(sd_journal *j) {
|
||||
pollfd.events = sd_journal_get_events(j);
|
||||
poll(&pollfd, 1, msec);
|
||||
return sd_journal_process(j);
|
||||
}</pre></div><div class="refsect1"><a name="idm214180851792"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
}</pre></div><div class="refsect1"><a name="idm214172211280"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_open.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_open</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
<a href="poll.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>,
|
||||
<a href="clock_gettime.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/poll.2.html"><span class="citerefentry"><span class="refentrytitle">poll</span>(2)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man2/clock_gettime.2.html"><span class="citerefentry"><span class="refentrytitle">clock_gettime</span>(2)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214202620928"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214171075312"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
the log journal for reading. It will find all journal
|
||||
files automatically and interleave them automatically
|
||||
when reading. As first argument it takes a pointer to
|
||||
@ -95,18 +95,18 @@
|
||||
locally, to its closest entry in time)
|
||||
<a href="sd_journal_seek_cursor.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_seek_cursor</span>(3)</span></a>.</p><p>Notification of journal changes is available via
|
||||
<code class="function">sd_journal_get_fd()</code> and related
|
||||
calls.</p></div><div class="refsect1"><a name="idm214202586464"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
calls.</p></div><div class="refsect1"><a name="idm214171040560"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code>, and
|
||||
<code class="function">sd_journal_open_files()</code> calls
|
||||
return 0 on success or a negative errno-style error
|
||||
code. <code class="function">sd_journal_close()</code> returns
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214202582256"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214171036352"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code> and
|
||||
<code class="function">sd_journal_close()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197661808"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214166120416"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_close()</code>,
|
||||
<code class="constant">SD_JOURNAL_LOCAL_ONLY</code>,
|
||||
<code class="constant">SD_JOURNAL_RUNTIME_ONLY</code>,
|
||||
@ -117,7 +117,7 @@
|
||||
and <code class="function">sd_journal_open_files()</code>
|
||||
were added in systemd-205.
|
||||
<code class="constant">SD_JOURNAL_SYSTEM_ONLY</code>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214197655472"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214166114080"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
|
||||
@ -19,14 +19,14 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_print"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_print, sd_journal_printv, sd_journal_send, sd_journal_sendv, sd_journal_perror, SD_JOURNAL_SUPPRESS_LOCATION — Submit log entries to the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_print</b>(</code></td><td>int <var class="pdparam">priority</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">format</var>, </td></tr><tr><td> </td><td>...<code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_printv</b>(</code></td><td>int <var class="pdparam">priority</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">format</var>, </td></tr><tr><td> </td><td>va_list <var class="pdparam">ap</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_send</b>(</code></td><td>const char *<var class="pdparam">format</var>, </td></tr><tr><td> </td><td>...<code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_sendv</b>(</code></td><td>const struct iovec *<var class="pdparam">iov</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">n</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_perror</b>(</code></td><td>const char *<var class="pdparam">message</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214193392656"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_print()</code> may be
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_print"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_print, sd_journal_printv, sd_journal_send, sd_journal_sendv, sd_journal_perror, SD_JOURNAL_SUPPRESS_LOCATION — Submit log entries to the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_print</b>(</code></td><td>int <var class="pdparam">priority</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">format</var>, </td></tr><tr><td> </td><td>...<code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_printv</b>(</code></td><td>int <var class="pdparam">priority</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">format</var>, </td></tr><tr><td> </td><td>va_list <var class="pdparam">ap</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_send</b>(</code></td><td>const char *<var class="pdparam">format</var>, </td></tr><tr><td> </td><td>...<code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_sendv</b>(</code></td><td>const struct iovec *<var class="pdparam">iov</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">n</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_perror</b>(</code></td><td>const char *<var class="pdparam">message</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214179273248"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_print()</code> may be
|
||||
used to submit simple, plain text log entries to the
|
||||
system journal. The first argument is a priority
|
||||
value. This is followed by a format string and its
|
||||
parameters, similar to
|
||||
<a href="printf.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/printf.3.html"><span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span></a>
|
||||
or
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>. The
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>. The
|
||||
priority value is one of
|
||||
<code class="constant">LOG_EMERG</code>,
|
||||
<code class="constant">LOG_ALERT</code>,
|
||||
@ -37,7 +37,7 @@
|
||||
<code class="constant">LOG_INFO</code>,
|
||||
<code class="constant">LOG_DEBUG</code>, as defined in
|
||||
<code class="filename">syslog.h</code>, see
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
for details. It is recommended to use this call to
|
||||
submit log messages in the application locale or system
|
||||
locale and in UTF-8 format, but no such restrictions
|
||||
@ -83,7 +83,7 @@
|
||||
the passed string, suffixed with ": " and a human
|
||||
readable representation of the current error code
|
||||
stored in
|
||||
<a href="errno.html"><span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span></a>. If
|
||||
<a href="http://man7.org/linux/man-pages/man3/errno.3.html"><span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span></a>. If
|
||||
the message string is passed as <code class="constant">NULL</code> or empty string,
|
||||
only the error string representation will be written,
|
||||
prefixed with nothing. An additional journal field
|
||||
@ -103,7 +103,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
|
||||
invoked. This is implemented with macros. If this is
|
||||
not desired, it can be turned off by defining
|
||||
SD_JOURNAL_SUPPRESS_LOCATION before including
|
||||
<code class="filename">sd-journal.h</code>.</p><p><a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
<code class="filename">sd-journal.h</code>.</p><p><a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
and <code class="function">sd_journal_print()</code> may
|
||||
largely be used interchangeably
|
||||
functionality-wise. However, note that log messages
|
||||
@ -118,32 +118,32 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
|
||||
log entries that are generated via
|
||||
<code class="function">sd_journal_send()</code>. Using
|
||||
<code class="function">syslog()</code> has the benefit of being
|
||||
more portable.</p></div><div class="refsect1"><a name="idm214193498576"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The four calls return 0 on success or a negative
|
||||
more portable.</p></div><div class="refsect1"><a name="idm214179230560"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The four calls return 0 on success or a negative
|
||||
errno-style error code. The
|
||||
<a href="errno.html"><span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/errno.3.html"><span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span></a>
|
||||
variable itself is not altered.</p><p>If
|
||||
<a href="systemd-journald.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald</span>(8)</span></a>
|
||||
is not running (the socket is not present), those
|
||||
functions do nothing, and also return 0.</p></div><div class="refsect1"><a name="idm214193495056"></a><h2 id="Async signal safety">Async signal safety<a class="headerlink" title="Permalink to this headline" href="#Async%20signal%20safety">¶</a></h2><p><code class="function">sd_journal_sendv()</code> is "async signal
|
||||
functions do nothing, and also return 0.</p></div><div class="refsect1"><a name="idm214174312880"></a><h2 id="Async signal safety">Async signal safety<a class="headerlink" title="Permalink to this headline" href="#Async%20signal%20safety">¶</a></h2><p><code class="function">sd_journal_sendv()</code> is "async signal
|
||||
safe" in the meaning of <a href="signal.html"><span class="citerefentry"><span class="refentrytitle">signal</span>(7)</span></a>.
|
||||
</p><p><code class="function">sd_journal_print</code>,
|
||||
<code class="function">sd_journal_printv</code>,
|
||||
<code class="function">sd_journal_send</code>, and
|
||||
<code class="function">sd_journal_perror</code> are
|
||||
not async signal safe.</p></div><div class="refsect1"><a name="idm214193489376"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_print()</code>,
|
||||
not async signal safe.</p></div><div class="refsect1"><a name="idm214174307824"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_print()</code>,
|
||||
<code class="function">sd_journal_printv()</code>,
|
||||
<code class="function">sd_journal_send()</code> and
|
||||
<code class="function">sd_journal_sendv()</code> interfaces
|
||||
are available as a shared library, which can be compiled
|
||||
and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214188855456"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214174302624"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_stream_fd.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_stream_fd</span>(3)</span></a>,
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>,
|
||||
<a href="perror.html"><span class="citerefentry"><span class="refentrytitle">perror</span>(3)</span></a>,
|
||||
<a href="errno.html"><span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/errno.3.html"><span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span></a>,
|
||||
<a href="systemd.journal-fields.html"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>,
|
||||
<a href="signal.html"><span class="citerefentry"><span class="refentrytitle">signal</span>(7)</span></a>,
|
||||
<a href="socket.html"><span class="citerefentry"><span class="refentrytitle">socket</span>(7)</span></a>
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214202620928"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_journal_open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_journal_open, sd_journal_open_directory, sd_journal_open_files, sd_journal_open_container, sd_journal_close, sd_journal, SD_JOURNAL_LOCAL_ONLY, SD_JOURNAL_RUNTIME_ONLY, SD_JOURNAL_SYSTEM, SD_JOURNAL_CURRENT_USER — Open the system journal for reading</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-journal.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_directory</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">path</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_files</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char **<var class="pdparam">paths</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_journal_open_container</b>(</code></td><td>sd_journal **<var class="pdparam">ret</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">machine</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">flags</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">sd_journal_close</b>(</code></td><td>sd_journal *<var class="pdparam">j</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214171075312"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_journal_open()</code> opens
|
||||
the log journal for reading. It will find all journal
|
||||
files automatically and interleave them automatically
|
||||
when reading. As first argument it takes a pointer to
|
||||
@ -95,18 +95,18 @@
|
||||
locally, to its closest entry in time)
|
||||
<a href="sd_journal_seek_cursor.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_seek_cursor</span>(3)</span></a>.</p><p>Notification of journal changes is available via
|
||||
<code class="function">sd_journal_get_fd()</code> and related
|
||||
calls.</p></div><div class="refsect1"><a name="idm214202586464"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
calls.</p></div><div class="refsect1"><a name="idm214171040560"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code>, and
|
||||
<code class="function">sd_journal_open_files()</code> calls
|
||||
return 0 on success or a negative errno-style error
|
||||
code. <code class="function">sd_journal_close()</code> returns
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214202582256"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
nothing.</p></div><div class="refsect1"><a name="idm214171036352"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>The <code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_open_directory()</code> and
|
||||
<code class="function">sd_journal_close()</code> interfaces are
|
||||
available as a shared library, which can be compiled and
|
||||
linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214197661808"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214166120416"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p><code class="function">sd_journal_open()</code>,
|
||||
<code class="function">sd_journal_close()</code>,
|
||||
<code class="constant">SD_JOURNAL_LOCAL_ONLY</code>,
|
||||
<code class="constant">SD_JOURNAL_RUNTIME_ONLY</code>,
|
||||
@ -117,7 +117,7 @@
|
||||
and <code class="function">sd_journal_open_files()</code>
|
||||
were added in systemd-205.
|
||||
<code class="constant">SD_JOURNAL_SYSTEM_ONLY</code>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214197655472"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
was deprecated.</p></div><div class="refsect1"><a name="idm214166114080"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
|
||||
<a href="sd_journal_next.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_next</span>(3)</span></a>,
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd_listen_fds"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_listen_fds, SD_LISTEN_FDS_START — Check for file descriptors passed by the system manager</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre><pre class="funcsynopsisinfo">#define SD_LISTEN_FDS_START 3</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_listen_fds</b>(</code></td><td>int <var class="pdparam">unset_environment</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214197560512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_listen_fds()</code> shall be
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd_listen_fds"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd_listen_fds, SD_LISTEN_FDS_START — Check for file descriptors passed by the system manager</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre><pre class="funcsynopsisinfo">#define SD_LISTEN_FDS_START 3</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">sd_listen_fds</b>(</code></td><td>int <var class="pdparam">unset_environment</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm214193016000"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="function">sd_listen_fds()</code> shall be
|
||||
called by a daemon to check for file descriptors
|
||||
passed by the init system as part of the socket-based
|
||||
activation logic.</p><p>If the <em class="parameter"><code>unset_environment</code></em>
|
||||
@ -50,7 +50,7 @@
|
||||
datagram or stream socket matters a lot for the most
|
||||
common program logics and should be checked.</p><p>This function call will set the FD_CLOEXEC flag
|
||||
for all passed file descriptors to avoid further
|
||||
inheritance to children of the calling process.</p></div><div class="refsect1"><a name="idm214197624416"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>On failure, this call returns a negative
|
||||
inheritance to children of the calling process.</p></div><div class="refsect1"><a name="idm214193005168"></a><h2 id="Return Value">Return Value<a class="headerlink" title="Permalink to this headline" href="#Return%20Value">¶</a></h2><p>On failure, this call returns a negative
|
||||
errno-style error code. If
|
||||
<code class="varname">$LISTEN_FDS</code>/<code class="varname">$LISTEN_PID</code>
|
||||
was not set or was not correctly set for this daemon and
|
||||
@ -58,9 +58,9 @@
|
||||
returned. Otherwise, the number of file descriptors
|
||||
passed is returned. The application may find them
|
||||
starting with file descriptor SD_LISTEN_FDS_START,
|
||||
i.e. file descriptor 3.</p></div><div class="refsect1"><a name="idm214197551888"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
i.e. file descriptor 3.</p></div><div class="refsect1"><a name="idm214196903888"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p><p>Internally, this function checks whether the
|
||||
<code class="varname">$LISTEN_PID</code> environment variable
|
||||
equals the daemon PID. If not, it returns
|
||||
@ -69,14 +69,14 @@
|
||||
variable, then sets the FD_CLOEXEC flag for the parsed
|
||||
number of file descriptors starting from
|
||||
SD_LISTEN_FDS_START. Finally, it returns the parsed
|
||||
number.</p></div><div class="refsect1"><a name="idm214197548512"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$LISTEN_PID"><span class="term"><code class="varname">$LISTEN_PID</code>, </span><span class="term"><code class="varname">$LISTEN_FDS</code></span><a class="headerlink" title="Permalink to this term" href="#%24LISTEN_PID">¶</a></dt><dd><p>Set by the init system
|
||||
number.</p></div><div class="refsect1"><a name="idm214196900512"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$LISTEN_PID"><span class="term"><code class="varname">$LISTEN_PID</code>, </span><span class="term"><code class="varname">$LISTEN_FDS</code></span><a class="headerlink" title="Permalink to this term" href="#%24LISTEN_PID">¶</a></dt><dd><p>Set by the init system
|
||||
for supervised processes that use
|
||||
socket-based activation. This
|
||||
environment variable specifies the
|
||||
data
|
||||
<code class="function">sd_listen_fds()</code>
|
||||
parses. See above for
|
||||
details.</p></dd></dl></div></div><div class="refsect1"><a name="idm214197690240"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
details.</p></dd></dl></div></div><div class="refsect1"><a name="idm214196895968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-daemon.html"><span class="citerefentry"><span class="refentrytitle">sd-daemon</span>(3)</span></a>,
|
||||
<a href="sd_is_fifo.html"><span class="citerefentry"><span class="refentrytitle">sd_is_fifo</span>(3)</span></a>,
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214195900512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="sd-daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sd-daemon, SD_EMERG, SD_ALERT, SD_CRIT, SD_ERR, SD_WARNING, SD_NOTICE, SD_INFO, SD_DEBUG — APIs for
|
||||
new-style daemons</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <systemd/sd-daemon.h></pre></div><div class="cmdsynopsis"><p><code class="command">pkg-config --cflags --libs libsystemd</code> </p></div></div><div class="refsect1"><a name="idm214169546224"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">sd-daemon.h</code> provide APIs
|
||||
for new-style daemons, as implemented by the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
init system.</p><p>See
|
||||
@ -41,22 +41,24 @@
|
||||
#define SD_DEBUG "<7>" /* debug-level messages */</pre><p>These prefixes are intended to be used in
|
||||
conjunction with stderr-based logging as implemented
|
||||
by systemd. If a systemd service definition file is
|
||||
configured with <code class="varname">StandardError=syslog</code>
|
||||
or <code class="varname">StandardError=kmsg</code>, these
|
||||
prefixes can be used to encode a log level in lines
|
||||
configured with
|
||||
<code class="varname">StandardError=journal</code>,
|
||||
<code class="varname">StandardError=syslog</code> or
|
||||
<code class="varname">StandardError=kmsg</code>, these prefixes
|
||||
can be used to encode a log level in lines
|
||||
printed. This is similar to the kernel
|
||||
<code class="function">printk()</code>-style logging. See
|
||||
<a href="klogctl.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/klogctl.2.html"><span class="citerefentry"><span class="refentrytitle">klogctl</span>(2)</span></a>
|
||||
for more information.</p><p>The log levels are identical to
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>'s
|
||||
log level system. To use these prefixes simply prefix
|
||||
every line with one of these strings. A line that is
|
||||
not prefixed will be logged at the default log level
|
||||
SD_INFO.</p><div class="example"><a name="idm214195045552"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214192388800"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
SD_INFO.</p><div class="example"><a name="idm214173485680"></a><p class="title"><b>Example 1. Hello World</b></p><div class="example-contents"><p>A daemon may log with the log level
|
||||
NOTICE by issuing this call:</p><pre class="programlisting">fprintf(stderr, SD_NOTICE "Hello World!\n");</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214167195408"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p><a name="pkgconfig-text"></a>These APIs are implemented as a shared
|
||||
library, which can be compiled and linked to with the
|
||||
<code class="constant">libsystemd</code> <a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214193723968"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="constant">libsystemd</code> <a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
file.</p></div><div class="refsect1"><a name="idm214173482912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>,
|
||||
@ -66,7 +68,6 @@
|
||||
<a href="daemon.html"><span class="citerefentry"><span class="refentrytitle">daemon</span>(7)</span></a>,
|
||||
<a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>,
|
||||
<a href="systemd.socket.html"><span class="citerefentry"><span class="refentrytitle">systemd.socket</span>(5)</span></a>,
|
||||
<a href="fprintf.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="sd-readahead.html"><span class="citerefentry"><span class="refentrytitle">sd-readahead</span>(3)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/fprintf.3.html"><span class="citerefentry"><span class="refentrytitle">fprintf</span>(3)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "BINFMT\&.D" "5" "" "systemd 215" "binfmt.d"
|
||||
.TH "BINFMT\&.D" "5" "" "systemd 217" "binfmt.d"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
@ -19,12 +19,12 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="binfmt.d"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>binfmt.d — Configure additional binary formats for
|
||||
executables at boot</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/binfmt.d/*.conf</code></p><p><code class="filename">/run/binfmt.d/*.conf</code></p><p><code class="filename">/usr/lib/binfmt.d/*.conf</code></p></div><div class="refsect1"><a name="idm214170142016"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>At boot,
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="binfmt.d"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>binfmt.d — Configure additional binary formats for
|
||||
executables at boot</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/binfmt.d/*.conf</code></p><p><code class="filename">/run/binfmt.d/*.conf</code></p><p><code class="filename">/usr/lib/binfmt.d/*.conf</code></p></div><div class="refsect1"><a name="idm214183102976"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>At boot,
|
||||
<a href="systemd-binfmt.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-binfmt.service</span>(8)</span></a>
|
||||
reads configuration files from the above directories
|
||||
to register in the kernel additional binary
|
||||
formats for executables.</p></div><div class="refsect1"><a name="idm214172795840"></a><h2 id="Configuration Format">Configuration Format<a class="headerlink" title="Permalink to this headline" href="#Configuration%20Format">¶</a></h2><p>Each file contains a list of binfmt_misc kernel
|
||||
formats for executables.</p></div><div class="refsect1"><a name="idm214183100752"></a><h2 id="Configuration Format">Configuration Format<a class="headerlink" title="Permalink to this headline" href="#Configuration%20Format">¶</a></h2><p>Each file contains a list of binfmt_misc kernel
|
||||
binary format rules. Consult <a class="ulink" href="https://www.kernel.org/doc/Documentation/binfmt_misc.txt" target="_top">binfmt_misc.txt</a>
|
||||
for more information on registration of additional
|
||||
binary formats and how to write rules.</p><p>Empty lines and lines beginning with ; and # are
|
||||
@ -50,10 +50,10 @@
|
||||
recommended way is to place a symlink to
|
||||
<code class="filename">/dev/null</code> in
|
||||
<code class="filename">/etc/binfmt.d/</code> bearing the
|
||||
same filename.</p></div><div class="refsect1"><a name="idm214169046960"></a><h2 id="Example">Example<a class="headerlink" title="Permalink to this headline" href="#Example">¶</a></h2><div class="example"><a name="idm214169046288"></a><p class="title"><b>Example 1. /etc/binfmt.d/wine.conf example:</b></p><div class="example-contents"><pre class="programlisting"># Start WINE on Windows executables
|
||||
:DOSWin:M::MZ::/usr/bin/wine:</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214169044640"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
same filename.</p></div><div class="refsect1"><a name="idm214186988656"></a><h2 id="Example">Example<a class="headerlink" title="Permalink to this headline" href="#Example">¶</a></h2><div class="example"><a name="idm214186987984"></a><p class="title"><b>Example 1. /etc/binfmt.d/wine.conf example:</b></p><div class="example-contents"><pre class="programlisting"># Start WINE on Windows executables
|
||||
:DOSWin:M::MZ::/usr/bin/wine:</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214186986384"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemd-binfmt.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-binfmt.service</span>(8)</span></a>,
|
||||
<a href="systemd-delta.html"><span class="citerefentry"><span class="refentrytitle">systemd-delta</span>(1)</span></a>,
|
||||
<a href="wine.html"><span class="citerefentry"><span class="refentrytitle">wine</span>(8)</span></a>
|
||||
<a href="http://linux.die.net/man/8/wine"><span class="citerefentry"><span class="refentrytitle">wine</span>(8)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -117,7 +117,7 @@
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-binfmt.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-delta</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>wine</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<citerefentry project='die-net'><refentrytitle>wine</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "BOOTCHART\&.CONF" "5" "" "systemd 215" "bootchart.conf"
|
||||
.TH "BOOTCHART\&.CONF" "5" "" "systemd 217" "bootchart.conf"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
@ -19,10 +19,10 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="bootchart.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>bootchart.conf — Boot performance analysis graphing tool configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/bootchart.conf</code></p></div><div class="refsect1"><a name="idm214168376384"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>When starting, systemd-bootchart will read the
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="bootchart.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>bootchart.conf — Boot performance analysis graphing tool configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/bootchart.conf</code></p></div><div class="refsect1"><a name="idm214181838560"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>When starting, systemd-bootchart will read the
|
||||
configuration file <code class="filename">bootchart.conf</code>.
|
||||
This configuration file determines logging parameters and
|
||||
graph output.</p></div><div class="refsect1"><a name="idm214170469440"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="Samples=500"><span class="term"><code class="varname">Samples=500</code></span><a class="headerlink" title="Permalink to this term" href="#Samples=500">¶</a></dt><dd><p>Configure the amount of samples to
|
||||
graph output.</p></div><div class="refsect1"><a name="idm214181836560"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="Samples=500"><span class="term"><code class="varname">Samples=500</code></span><a class="headerlink" title="Permalink to this term" href="#Samples=500">¶</a></dt><dd><p>Configure the amount of samples to
|
||||
record in total before bootchart exits. Each sample will
|
||||
record at intervals defined by Frequency=.</p></dd><dt id="Frequency=25"><span class="term"><code class="varname">Frequency=25</code></span><a class="headerlink" title="Permalink to this term" href="#Frequency=25">¶</a></dt><dd><p>Configure the sample log frequency.
|
||||
This can be a fractional number, but must be larger than
|
||||
@ -48,7 +48,7 @@
|
||||
of processes' PSS memory consumption.</p></dd><dt id="PlotEntropyGraph=no"><span class="term"><code class="varname">PlotEntropyGraph=no</code></span><a class="headerlink" title="Permalink to this term" href="#PlotEntropyGraph=no">¶</a></dt><dd><p>If set to yes, enables logging and graphing
|
||||
of the kernel random entropy pool size.</p></dd><dt id="ScaleX=100"><span class="term"><code class="varname">ScaleX=100</code></span><a class="headerlink" title="Permalink to this term" href="#ScaleX=100">¶</a></dt><dd><p>Horizontal scaling factor for all variable
|
||||
graph components.</p></dd><dt id="ScaleY=20"><span class="term"><code class="varname">ScaleY=20</code></span><a class="headerlink" title="Permalink to this term" href="#ScaleY=20">¶</a></dt><dd><p>Vertical scaling factor for all variable
|
||||
graph components.</p></dd><dt id="ControlGroup=no"><span class="term"><code class="varname">ControlGroup=no</code></span><a class="headerlink" title="Permalink to this term" href="#ControlGroup=no">¶</a></dt><dd><p>Display process control group.</p></dd></dl></div></div><div class="refsect1"><a name="idm214170612832"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
graph components.</p></dd><dt id="ControlGroup=no"><span class="term"><code class="varname">ControlGroup=no</code></span><a class="headerlink" title="Permalink to this term" href="#ControlGroup=no">¶</a></dt><dd><p>Display process control group.</p></dd></dl></div></div><div class="refsect1"><a name="idm214185714512"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd-bootchart.html"><span class="citerefentry"><span class="refentrytitle">systemd-bootchart</span>(1)</span></a>,
|
||||
<a href="systemd.directives.html"><span class="citerefentry"><span class="refentrytitle">systemd.directives</span>(7)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "BOOTCTL" "1" "" "systemd 215" "bootctl"
|
||||
.TH "BOOTCTL" "1" "" "systemd 217" "bootctl"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
@ -19,18 +19,18 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="bootctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>bootctl — Control the firmware and boot manager settings</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">bootctl</code> [OPTIONS...] {COMMAND}</p></div></div><div class="refsect1"><a name="idm214180461680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>bootctl</strong></span> may be used to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="bootctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>bootctl — Control the firmware and boot manager settings</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">bootctl</code> [OPTIONS...] {COMMAND}</p></div></div><div class="refsect1"><a name="idm214181115680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>bootctl</strong></span> may be used to
|
||||
query or (in the future) change the firmware and boot
|
||||
manager settings.</p><p>Firmware information is available only on EFI
|
||||
systems.</p><p>Currently, only the <a href="gummiboot.html"><span class="citerefentry"><span class="refentrytitle">gummiboot</span>(8)</span></a> boot
|
||||
systems.</p><p>Currently, only the <span class="citerefentry"><span class="refentrytitle">gummiboot</span>(8)</span> boot
|
||||
manager implements the required boot loader interface
|
||||
to provide complete boot manager information.</p></div><div class="refsect1"><a name="idm214180504032"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
to provide complete boot manager information.</p></div><div class="refsect1"><a name="idm214181111728"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd></dl></div><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="status"><span class="term"><span class="command"><strong>status</strong></span></span><a class="headerlink" title="Permalink to this term" href="#status">¶</a></dt><dd><p>Show firmware and boot
|
||||
manager information about the system,
|
||||
including secure boot mode status and
|
||||
selected firmware entry (where
|
||||
available).</p></dd></dl></div></div><div class="refsect1"><a name="idm214176713504"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
||||
code otherwise.</p></div><div class="refsect1"><a name="idm214176712320"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
available).</p></dd></dl></div></div><div class="refsect1"><a name="idm214181105648"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
||||
code otherwise.</p></div><div class="refsect1"><a name="idm214181104464"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a class="ulink" href="http://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface" target="_top">Boot loader interface</a>,
|
||||
<a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec" target="_top">Boot loader specification</a>,
|
||||
<a class="ulink" href="http://www.freedesktop.org/wiki/Software/gummiboot/" target="_top">gummiboot</a>
|
||||
|
||||
@ -64,7 +64,7 @@
|
||||
<para>Firmware information is available only on EFI
|
||||
systems.</para>
|
||||
|
||||
<para>Currently, only the <citerefentry><refentrytitle>gummiboot</refentrytitle><manvolnum>8</manvolnum></citerefentry> boot
|
||||
<para>Currently, only the <citerefentry project='gummiboot'><refentrytitle>gummiboot</refentrytitle><manvolnum>8</manvolnum></citerefentry> boot
|
||||
manager implements the required boot loader interface
|
||||
to provide complete boot manager information.</para>
|
||||
</refsect1>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "BOOTUP" "7" "" "systemd 215" "bootup"
|
||||
.TH "BOOTUP" "7" "" "systemd 217" "bootup"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="bootup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>bootup — System bootup process</p></div><div class="refsect1"><a name="idm214175133552"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>A number of different components are involved in
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="bootup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>bootup — System bootup process</p></div><div class="refsect1"><a name="idm214198228736"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>A number of different components are involved in
|
||||
the system boot. Immediately after power-up, the
|
||||
system BIOS will do minimal hardware initialization,
|
||||
and hand control over to a boot loader stored on a
|
||||
@ -28,7 +28,7 @@
|
||||
Linux case, this kernel (optionally) extracts and
|
||||
executes an initial RAM disk image (initrd), such as
|
||||
generated by
|
||||
<a href="dracut.html"><span class="citerefentry"><span class="refentrytitle">dracut</span>(8)</span></a>,
|
||||
<a href="http://linux.die.net/man/8/dracut"><span class="citerefentry"><span class="refentrytitle">dracut</span>(8)</span></a>,
|
||||
which looks for the root file system (possibly using
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
for this). After the root file system is found and
|
||||
@ -45,7 +45,7 @@
|
||||
unmounts/detaches the root file system and the storage
|
||||
it resides on. As a last step, the system is powered down.</p><p>Additional information about the system boot
|
||||
process may be found in
|
||||
<a href="boot.html"><span class="citerefentry"><span class="refentrytitle">boot</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm214172705392"></a><h2 id="System Manager Bootup">System Manager Bootup<a class="headerlink" title="Permalink to this headline" href="#System%20Manager%20Bootup">¶</a></h2><p>At boot, the system manager on the OS image is
|
||||
<a href="http://man7.org/linux/man-pages/man7/boot.7.html"><span class="citerefentry"><span class="refentrytitle">boot</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm214194438320"></a><h2 id="System Manager Bootup">System Manager Bootup<a class="headerlink" title="Permalink to this headline" href="#System%20Manager%20Bootup">¶</a></h2><p>At boot, the system manager on the OS image is
|
||||
responsible for initializing the required file
|
||||
systems, services and drivers that are necessary for
|
||||
operation of the system. On
|
||||
@ -124,7 +124,7 @@
|
||||
option (see
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>)
|
||||
or by symlinking <code class="filename">default.target</code>
|
||||
to them.</p></div><div class="refsect1"><a name="idm214174200976"></a><h2 id="Bootup in the Initial RAM Disk (initrd)">Bootup in the Initial RAM Disk (initrd)<a class="headerlink" title="Permalink to this headline" href="#Bootup%20in%20the%20Initial%20RAM%20Disk%20(initrd)">¶</a></h2><p>The initial RAM disk implementation (initrd) can
|
||||
to them.</p></div><div class="refsect1"><a name="idm214198321168"></a><h2 id="Bootup in the Initial RAM Disk (initrd)">Bootup in the Initial RAM Disk (initrd)<a class="headerlink" title="Permalink to this headline" href="#Bootup%20in%20the%20Initial%20RAM%20Disk%20(initrd)">¶</a></h2><p>The initial RAM disk implementation (initrd) can
|
||||
be set up using systemd as well. In this case, boot up
|
||||
inside the initrd follows the following
|
||||
structure.</p><p>The default target in the initrd is
|
||||
@ -202,7 +202,7 @@
|
||||
initrd-switch-root.service
|
||||
|
|
||||
v
|
||||
Transition to Host OS</pre></div><div class="refsect1"><a name="idm214171319504"></a><h2 id="System Manager Shutdown">System Manager Shutdown<a class="headerlink" title="Permalink to this headline" href="#System%20Manager%20Shutdown">¶</a></h2><p>System shutdown with systemd also consists of
|
||||
Transition to Host OS</pre></div><div class="refsect1"><a name="idm214198296176"></a><h2 id="System Manager Shutdown">System Manager Shutdown<a class="headerlink" title="Permalink to this headline" href="#System%20Manager%20Shutdown">¶</a></h2><p>System shutdown with systemd also consists of
|
||||
various target units with some minimal ordering
|
||||
structure applied:</p><pre class="programlisting"> (conflicts with (conflicts with
|
||||
all system all file system
|
||||
@ -229,10 +229,10 @@
|
||||
systemd-reboot.service systemd-poweroff.service systemd-halt.service systemd-kexec.service
|
||||
| | | |
|
||||
v v v v
|
||||
<span class="emphasis"><em>reboot.target</em></span> <span class="emphasis"><em>poweroff.target</em></span> <span class="emphasis"><em>halt.target</em></span> <span class="emphasis"><em>kexec.target</em></span></pre><p>Commonly used system shutdown targets are <span class="emphasis"><em>emphasized</em></span>.</p></div><div class="refsect1"><a name="idm214172155856"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<span class="emphasis"><em>reboot.target</em></span> <span class="emphasis"><em>poweroff.target</em></span> <span class="emphasis"><em>halt.target</em></span> <span class="emphasis"><em>kexec.target</em></span></pre><p>Commonly used system shutdown targets are <span class="emphasis"><em>emphasized</em></span>.</p></div><div class="refsect1"><a name="idm214198288240"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="boot.html"><span class="citerefentry"><span class="refentrytitle">boot</span>(7)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man7/boot.7.html"><span class="citerefentry"><span class="refentrytitle">boot</span>(7)</span></a>,
|
||||
<a href="systemd.special.html"><span class="citerefentry"><span class="refentrytitle">systemd.special</span>(7)</span></a>,
|
||||
<a href="systemd.target.html"><span class="citerefentry"><span class="refentrytitle">systemd.target</span>(5)</span></a>,
|
||||
<a href="dracut.html"><span class="citerefentry"><span class="refentrytitle">dracut</span>(8)</span></a>
|
||||
<a href="http://linux.die.net/man/8/dracut"><span class="citerefentry"><span class="refentrytitle">dracut</span>(8)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
Linux case, this kernel (optionally) extracts and
|
||||
executes an initial RAM disk image (initrd), such as
|
||||
generated by
|
||||
<citerefentry><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry project='die-net'><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
which looks for the root file system (possibly using
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
for this). After the root file system is found and
|
||||
@ -80,7 +80,7 @@
|
||||
|
||||
<para>Additional information about the system boot
|
||||
process may be found in
|
||||
<citerefentry><refentrytitle>boot</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
|
||||
<citerefentry project='man-pages'><refentrytitle>boot</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
@ -308,10 +308,10 @@ systemd-reboot.service systemd-poweroff.service systemd-halt.service syste
|
||||
<title>See Also</title>
|
||||
<para>
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>boot</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>boot</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd.target</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<citerefentry project='die-net'><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "BUSCTL" "1" "" "systemd 215" "busctl"
|
||||
.TH "BUSCTL" "1" "" "systemd 217" "busctl"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="busctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>busctl — Introspect the bus</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">busctl</code> [OPTIONS...] [COMMAND] [<em class="replaceable"><code>NAME</code></em>...]</p></div></div><div class="refsect1"><a name="idm214187534608"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>busctl</strong></span> may be used to
|
||||
introspect and monitor the D-Bus bus.</p></div><div class="refsect1"><a name="idm214188850608"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--address=ADDRESS"><span class="term"><code class="option">--address=<em class="replaceable"><code>ADDRESS</code></em></code></span><a class="headerlink" title="Permalink to this term" href="#--address=ADDRESS">¶</a></dt><dd><p>Connect to the bus specified by
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="busctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>busctl — Introspect the bus</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">busctl</code> [OPTIONS...] [COMMAND] [<em class="replaceable"><code>NAME</code></em>...]</p></div></div><div class="refsect1"><a name="idm214179011280"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>busctl</strong></span> may be used to
|
||||
introspect and monitor the D-Bus bus.</p></div><div class="refsect1"><a name="idm214179009536"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--address=ADDRESS"><span class="term"><code class="option">--address=<em class="replaceable"><code>ADDRESS</code></em></code></span><a class="headerlink" title="Permalink to this term" href="#--address=ADDRESS">¶</a></dt><dd><p>Connect to the bus specified by
|
||||
<em class="replaceable"><code>ADDRESS</code></em> instead of using suitable
|
||||
defaults for either the system or user bus (see
|
||||
<code class="option">--system</code> and <code class="option">--user</code>
|
||||
@ -49,12 +49,12 @@
|
||||
<span class="command"><strong>machinectl -H
|
||||
<em class="replaceable"><code>HOST</code></em></strong></span>.</p></dd><dt id="-M"><span class="term"><code class="option">-M</code>, </span><span class="term"><code class="option">--machine=</code></span><a class="headerlink" title="Permalink to this term" href="#-M">¶</a></dt><dd><p><a name="machine-text"></a>Execute operation on a local container. Specify a
|
||||
container name to connect to.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div></div><div class="refsect1"><a name="idm214187800176"></a><h2 id="Commands">Commands<a class="headerlink" title="Permalink to this headline" href="#Commands">¶</a></h2><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="list"><span class="term"><span class="command"><strong>list</strong></span></span><a class="headerlink" title="Permalink to this term" href="#list">¶</a></dt><dd><p>Show endpoints attached to the bus. This is
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div></div><div class="refsect1"><a name="idm214182885360"></a><h2 id="Commands">Commands<a class="headerlink" title="Permalink to this headline" href="#Commands">¶</a></h2><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="list"><span class="term"><span class="command"><strong>list</strong></span></span><a class="headerlink" title="Permalink to this term" href="#list">¶</a></dt><dd><p>Show endpoints attached to the bus. This is
|
||||
the default if no command is specified.</p></dd><dt id="monitor NAME"><span class="term"><span class="command"><strong>monitor</strong></span> [<em class="replaceable"><code>NAME</code></em>...]</span><a class="headerlink" title="Permalink to this term" href="#monitor%20%20NAME">¶</a></dt><dd><p>Dump messages being exchanged. If
|
||||
<em class="replaceable"><code>NAME</code></em> is specified, show messages
|
||||
to or from this endpoint. Otherwise, show all messages on the
|
||||
bus.</p></dd><dt id="status NAME"><span class="term"><span class="command"><strong>status</strong></span> <em class="replaceable"><code>NAME</code></em> </span><a class="headerlink" title="Permalink to this term" href="#status%20%20NAME">¶</a></dt><dd><p>Show process information and credentials of a
|
||||
bus endpoint.</p></dd><dt id="help"><span class="term"><span class="command"><strong>help</strong></span></span><a class="headerlink" title="Permalink to this term" href="#help">¶</a></dt><dd><p>Show command syntax help.</p></dd></dl></div></div><div class="refsect1"><a name="idm214188024640"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
bus endpoint.</p></dd><dt id="help"><span class="term"><span class="command"><strong>help</strong></span></span><a class="headerlink" title="Permalink to this term" href="#help">¶</a></dt><dd><p>Show command syntax help.</p></dd></dl></div></div><div class="refsect1"><a name="idm214182866752"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="dbus-daemon.html"><span class="citerefentry"><span class="refentrytitle">dbus-daemon</span>(1)</span></a>,
|
||||
<a class="ulink" href="http://freedesktop.org/wiki/Software/dbus" target="_top">D-Bus</a>,
|
||||
<a class="ulink" href="https://code.google.com/p/d-bus/" target="_top">kdbus</a>,
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "COREDUMP\&.CONF" "5" "" "systemd 215" "coredump.conf"
|
||||
.TH "COREDUMP\&.CONF" "5" "" "systemd 217" "coredump.conf"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -74,7 +74,7 @@ Enforce limits on the disk space taken up by externally stored coredumps\&.
|
||||
\fBMaxUse=\fR
|
||||
makes sure that old coredumps are removed as soon as the total disk space taken up by coredumps grows beyond this limit (defaults to 10% of the total disk size)\&.
|
||||
\fBKeepFree=\fR
|
||||
controls how much disk space to keep free at least (defaults to 15% of the total disk size)\&. Note that the disk space used by coredumps might temporarily exceed these limits while coredumps are processed\&. Note that old coredumps are also removed based on on time via
|
||||
controls how much disk space to keep free at least (defaults to 15% of the total disk size)\&. Note that the disk space used by coredumps might temporarily exceed these limits while coredumps are processed\&. Note that old coredumps are also removed based on time via
|
||||
\fBsystemd-tmpfiles\fR(8)\&.
|
||||
.RE
|
||||
.SH "SEE ALSO"
|
||||
|
||||
@ -19,8 +19,8 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="coredump.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>coredump.conf — Coredump storage configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/coredump.conf</code></p></div><div class="refsect1"><a name="idm214179163936"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>This file configures the behaviour of <span class="command"><strong>systemd-coredump</strong></span>,
|
||||
a handler for core dumps invoked by the kernel.</p></div><div class="refsect1"><a name="idm214183007376"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>All options are configured in the
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="coredump.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>coredump.conf — Coredump storage configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/coredump.conf</code></p></div><div class="refsect1"><a name="idm214198160864"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>This file configures the behaviour of <span class="command"><strong>systemd-coredump</strong></span>,
|
||||
a handler for core dumps invoked by the kernel.</p></div><div class="refsect1"><a name="idm214198159056"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>All options are configured in the
|
||||
"<code class="literal">[Coredump]</code>" section:</p><div class="variablelist"><dl class="variablelist"><dt id="Storage="><span class="term"><code class="varname">Storage=</code></span><a class="headerlink" title="Permalink to this term" href="#Storage=">¶</a></dt><dd><p>Controls where to store cores. One of
|
||||
"<code class="literal">none</code>", "<code class="literal">external</code>",
|
||||
"<code class="literal">journal</code>", and "<code class="literal">both</code>". When
|
||||
@ -49,8 +49,8 @@
|
||||
to 15% of the total disk size). Note that the disk space used
|
||||
by coredumps might temporarily exceed these limits while
|
||||
coredumps are processed. Note that old coredumps are also
|
||||
removed based on on time via
|
||||
<a href="systemd-tmpfiles.html"><span class="citerefentry"><span class="refentrytitle">systemd-tmpfiles</span>(8)</span></a>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214183150560"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
removed based on time via
|
||||
<a href="systemd-tmpfiles.html"><span class="citerefentry"><span class="refentrytitle">systemd-tmpfiles</span>(8)</span></a>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214202036848"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd-journald.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>,
|
||||
<a href="coredumpctl.html"><span class="citerefentry"><span class="refentrytitle">coredumpctl</span>(1)</span></a>,
|
||||
<a href="systemd-tmpfiles.html"><span class="citerefentry"><span class="refentrytitle">systemd-tmpfiles</span>(8)</span></a>
|
||||
|
||||
@ -126,7 +126,7 @@
|
||||
to 15% of the total disk size). Note that the disk space used
|
||||
by coredumps might temporarily exceed these limits while
|
||||
coredumps are processed. Note that old coredumps are also
|
||||
removed based on on time via
|
||||
removed based on time via
|
||||
<citerefentry><refentrytitle>systemd-tmpfiles</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "COREDUMPCTL" "1" "" "systemd 215" "coredumpctl"
|
||||
.TH "COREDUMPCTL" "1" "" "systemd 217" "coredumpctl"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -120,7 +120,58 @@ General journalctl predicates (see
|
||||
.SH "EXIT STATUS"
|
||||
.PP
|
||||
On success, 0 is returned; otherwise, a non\-zero failure code is returned\&. Not finding any matching coredumps is treated as failure\&.
|
||||
.SH "EXAMPLES"
|
||||
.PP
|
||||
\fBExample\ \&1.\ \&List all the coredumps of a program named foo\fR
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
# coredumpctl list foo
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBExample\ \&2.\ \&Invoke gdb on the last coredump\fR
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
# coredumpctl gdb
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBExample\ \&3.\ \&Show information about a process that dumped core, matching by its PID 6654\fR
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
# coredumpctl info 6654
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBExample\ \&4.\ \&Extract the last coredump of /usr/bin/bar to a file named bar.coredump\fR
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
# coredumpctl \-o bar\&.coredump dump /usr/bin/bar
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "SEE ALSO"
|
||||
.PP
|
||||
\fBsystemd-coredump\fR(8),
|
||||
\fBcoredump.conf\fR(5),
|
||||
\fBsystemd-journald.service\fR(8),
|
||||
\fBgdb\fR(1)
|
||||
|
||||
@ -19,9 +19,9 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="coredumpctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>coredumpctl — Retrieve coredumps from the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">coredumpctl</code> [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]</p></div></div><div class="refsect1"><a name="idm214194795776"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>coredumpctl</strong></span> may be used to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="coredumpctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>coredumpctl — Retrieve coredumps from the journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">coredumpctl</code> [OPTIONS...] {COMMAND} [PID|COMM|EXE|MATCH...]</p></div></div><div class="refsect1"><a name="idm214185460480"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>coredumpctl</strong></span> may be used to
|
||||
retrieve coredumps from
|
||||
<a href="systemd-journald.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald</span>(8)</span></a>.</p></div><div class="refsect1"><a name="idm214194840048"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-legend"><span class="term"><code class="option">--no-legend</code></span><a class="headerlink" title="Permalink to this term" href="#--no-legend">¶</a></dt><dd><p>Do not print the column headers.
|
||||
<a href="systemd-journald.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald</span>(8)</span></a>.</p></div><div class="refsect1"><a name="idm214185457936"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-legend"><span class="term"><code class="option">--no-legend</code></span><a class="headerlink" title="Permalink to this term" href="#--no-legend">¶</a></dt><dd><p>Do not print the column headers.
|
||||
</p></dd><dt id="-1"><span class="term"><code class="option">-1</code></span><a class="headerlink" title="Permalink to this term" href="#-1">¶</a></dt><dd><p>Show information of a
|
||||
single coredump only, instead of
|
||||
listing all known coredumps.
|
||||
@ -44,7 +44,7 @@
|
||||
</p></dd><dt id="gdb"><span class="term"><span class="command"><strong>gdb</strong></span></span><a class="headerlink" title="Permalink to this term" href="#gdb">¶</a></dt><dd><p>Invoke the GNU
|
||||
debugger on the last coredump matching
|
||||
specified characteristics.
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214194937296"></a><h2 id="Matching">Matching<a class="headerlink" title="Permalink to this headline" href="#Matching">¶</a></h2><p>A match can be:</p><div class="variablelist"><dl class="variablelist"><dt id="PID"><span class="term"><em class="replaceable"><code>PID</code></em></span><a class="headerlink" title="Permalink to this term" href="#PID">¶</a></dt><dd><p>Process ID of the
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214189336496"></a><h2 id="Matching">Matching<a class="headerlink" title="Permalink to this headline" href="#Matching">¶</a></h2><p>A match can be:</p><div class="variablelist"><dl class="variablelist"><dt id="PID"><span class="term"><em class="replaceable"><code>PID</code></em></span><a class="headerlink" title="Permalink to this term" href="#PID">¶</a></dt><dd><p>Process ID of the
|
||||
process that dumped
|
||||
core. An integer.</p></dd><dt id="COMM"><span class="term"><em class="replaceable"><code>COMM</code></em></span><a class="headerlink" title="Permalink to this term" href="#COMM">¶</a></dt><dd><p>Name of the executable
|
||||
(matches <code class="option">COREDUMP_COMM=</code>).
|
||||
@ -55,10 +55,12 @@
|
||||
</p></dd><dt id="MATCH"><span class="term"><em class="replaceable"><code>MATCH</code></em></span><a class="headerlink" title="Permalink to this term" href="#MATCH">¶</a></dt><dd><p>General journalctl predicates
|
||||
(see <a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>).
|
||||
Must contain an equal sign.
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214194927856"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned; otherwise, a non-zero failure
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214189319792"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned; otherwise, a non-zero failure
|
||||
code is returned. Not finding any matching coredumps is treated
|
||||
as failure.
|
||||
</p></div><div class="refsect1"><a name="idm214194926480"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
</p></div><div class="refsect1"><a name="idm214189318416"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><div class="example"><a name="idm214189317744"></a><p class="title"><b>Example 1. List all the coredumps of a program named foo</b></p><div class="example-contents"><pre class="programlisting"># coredumpctl list foo</pre></div></div><br class="example-break"><div class="example"><a name="idm214189316288"></a><p class="title"><b>Example 2. Invoke gdb on the last coredump</b></p><div class="example-contents"><pre class="programlisting"># coredumpctl gdb</pre></div></div><br class="example-break"><div class="example"><a name="idm214189314784"></a><p class="title"><b>Example 3. Show information about a process that dumped core, matching by its PID 6654</b></p><div class="example-contents"><pre class="programlisting"># coredumpctl info 6654</pre></div></div><br class="example-break"><div class="example"><a name="idm214189313328"></a><p class="title"><b>Example 4. Extract the last coredump of /usr/bin/bar to a file named bar.coredump</b></p><div class="example-contents"><pre class="programlisting"># coredumpctl -o bar.coredump dump /usr/bin/bar</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214189311776"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd-coredump.html"><span class="citerefentry"><span class="refentrytitle">systemd-coredump</span>(8)</span></a>,
|
||||
<a href="coredump.conf.html"><span class="citerefentry"><span class="refentrytitle">coredump.conf</span>(5)</span></a>,
|
||||
<a href="systemd-journald.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>,
|
||||
<a href="gdb.html"><span class="citerefentry"><span class="refentrytitle">gdb</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man1/gdb.1.html"><span class="citerefentry"><span class="refentrytitle">gdb</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -207,11 +207,41 @@
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Examples</title>
|
||||
|
||||
<example>
|
||||
<title>List all the coredumps of a program named foo</title>
|
||||
|
||||
<programlisting># coredumpctl list foo</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>Invoke gdb on the last coredump</title>
|
||||
|
||||
<programlisting># coredumpctl gdb</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>Show information about a process that dumped core, matching by its PID 6654</title>
|
||||
|
||||
<programlisting># coredumpctl info 6654</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>Extract the last coredump of /usr/bin/bar to a file named bar.coredump</title>
|
||||
|
||||
<programlisting># coredumpctl -o bar.coredump dump /usr/bin/bar</programlisting>
|
||||
</example>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>See Also</title>
|
||||
<para>
|
||||
<citerefentry><refentrytitle>systemd-coredump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>coredump.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
<citerefentry project='man-pages'><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "CRYPTTAB" "5" "" "systemd 215" "crypttab"
|
||||
.TH "CRYPTTAB" "5" "" "systemd 217" "crypttab"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -196,6 +196,15 @@ Use TrueCrypt in system encryption mode\&. This option implies
|
||||
Specifies the timeout for querying for a password\&. If no unit is specified, seconds is used\&. Supported units are s, ms, us, min, h, d\&. A timeout of 0 waits indefinitely (which is the default)\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBx\-systemd\&.device\-timeout=\fR
|
||||
.RS 4
|
||||
Specifies how long systemd should wait for a device to show up before giving up on the entry\&. The argument is a time in seconds or explicitly specifified units of
|
||||
"s",
|
||||
"min",
|
||||
"h",
|
||||
"ms"\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBtmp\fR
|
||||
.RS 4
|
||||
The encrypted block device will be prepared for using it as
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="crypttab"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>crypttab — Configuration for encrypted block devices</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/crypttab</code></p></div><div class="refsect1"><a name="idm214179029408"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>The <code class="filename">/etc/crypttab</code> file
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="crypttab"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>crypttab — Configuration for encrypted block devices</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/crypttab</code></p></div><div class="refsect1"><a name="idm214195524688"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>The <code class="filename">/etc/crypttab</code> file
|
||||
describes encrypted block devices that are set up
|
||||
during system boot.</p><p>Empty lines and lines starting with the "<code class="literal">#</code>"
|
||||
character are ignored. Each of the remaining lines
|
||||
@ -97,7 +97,7 @@
|
||||
be used as a swap device, and will be formatted
|
||||
accordingly after setting up the encrypted
|
||||
block device, with
|
||||
<a href="mkswap.html"><span class="citerefentry"><span class="refentrytitle">mkswap</span>(8)</span></a>.
|
||||
<a href="http://man7.org/linux/man-pages/man8/mkswap.8.html"><span class="citerefentry"><span class="refentrytitle">mkswap</span>(8)</span></a>.
|
||||
This option implies <code class="option">plain</code>.</p><p>WARNING: Using the <code class="option">swap</code>
|
||||
option will destroy the contents of the named
|
||||
partition during every boot, so make sure the
|
||||
@ -139,10 +139,19 @@
|
||||
querying for a password. If no unit is
|
||||
specified, seconds is used. Supported units are
|
||||
s, ms, us, min, h, d. A timeout of 0 waits
|
||||
indefinitely (which is the default).</p></dd><dt id="tmp"><span class="term"><code class="option">tmp</code></span><a class="headerlink" title="Permalink to this term" href="#tmp">¶</a></dt><dd><p>The encrypted block device will
|
||||
indefinitely (which is the default).</p></dd><dt id="x-systemd.device-timeout="><span class="term"><code class="option">x-systemd.device-timeout=</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.device-timeout=">¶</a></dt><dd><p>Specifies how long
|
||||
systemd should wait for a device to
|
||||
show up before giving up on the
|
||||
entry. The argument is a time in
|
||||
seconds or explicitly specifified
|
||||
units of "<code class="literal">s</code>",
|
||||
"<code class="literal">min</code>",
|
||||
"<code class="literal">h</code>",
|
||||
"<code class="literal">ms</code>".
|
||||
</p></dd><dt id="tmp"><span class="term"><code class="option">tmp</code></span><a class="headerlink" title="Permalink to this term" href="#tmp">¶</a></dt><dd><p>The encrypted block device will
|
||||
be prepared for using it as <code class="filename">/tmp</code>;
|
||||
it will be formatted using
|
||||
<a href="mke2fs.html"><span class="citerefentry"><span class="refentrytitle">mke2fs</span>(8)</span></a>.
|
||||
<a href="http://man7.org/linux/man-pages/man8/mke2fs.8.html"><span class="citerefentry"><span class="refentrytitle">mke2fs</span>(8)</span></a>.
|
||||
This option implies <code class="option">plain</code>.</p><p>WARNING: Using the <code class="option">tmp</code>
|
||||
option will destroy the contents of the named
|
||||
partition during every boot, so make sure the
|
||||
@ -154,16 +163,16 @@
|
||||
prevent typos.</p></dd></dl></div><p>At early boot and when the system manager
|
||||
configuration is reloaded, this file is translated into
|
||||
native systemd units
|
||||
by <a href="systemd-cryptsetup-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-cryptsetup-generator</span>(8)</span></a>.</p></div><div class="refsect1"><a name="idm214174457600"></a><h2 id="Example">Example<a class="headerlink" title="Permalink to this headline" href="#Example">¶</a></h2><div class="example"><a name="idm214174456960"></a><p class="title"><b>Example 1. /etc/crypttab example</b></p><div class="example-contents"><p>Set up four encrypted block devices. One using
|
||||
by <a href="systemd-cryptsetup-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-cryptsetup-generator</span>(8)</span></a>.</p></div><div class="refsect1"><a name="idm214194423648"></a><h2 id="Example">Example<a class="headerlink" title="Permalink to this headline" href="#Example">¶</a></h2><div class="example"><a name="idm214194423008"></a><p class="title"><b>Example 1. /etc/crypttab example</b></p><div class="example-contents"><p>Set up four encrypted block devices. One using
|
||||
LUKS for normal storage, another one for usage as a swap
|
||||
device and two TrueCrypt volumes.</p><pre class="programlisting">luks UUID=2505567a-9e27-4efe-a4d5-15ad146c258b
|
||||
swap /dev/sda7 /dev/urandom swap
|
||||
truecrypt /dev/sda2 /etc/container_password tcrypt
|
||||
hidden /mnt/tc_hidden /dev/null tcrypt-hidden,tcrypt-keyfile=/etc/keyfile</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214174454576"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
hidden /mnt/tc_hidden /dev/null tcrypt-hidden,tcrypt-keyfile=/etc/keyfile</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm214194420624"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemd-cryptsetup@.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-cryptsetup@.service</span>(8)</span></a>,
|
||||
<a href="systemd-cryptsetup-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-cryptsetup-generator</span>(8)</span></a>,
|
||||
<a href="cryptsetup.html"><span class="citerefentry"><span class="refentrytitle">cryptsetup</span>(8)</span></a>,
|
||||
<a href="mkswap.html"><span class="citerefentry"><span class="refentrytitle">mkswap</span>(8)</span></a>,
|
||||
<a href="mke2fs.html"><span class="citerefentry"><span class="refentrytitle">mke2fs</span>(8)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man8/mkswap.8.html"><span class="citerefentry"><span class="refentrytitle">mkswap</span>(8)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man8/mke2fs.8.html"><span class="citerefentry"><span class="refentrytitle">mke2fs</span>(8)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -233,7 +233,7 @@
|
||||
be used as a swap device, and will be formatted
|
||||
accordingly after setting up the encrypted
|
||||
block device, with
|
||||
<citerefentry><refentrytitle>mkswap</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
<citerefentry project='man-pages'><refentrytitle>mkswap</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
This option implies <option>plain</option>.</para>
|
||||
|
||||
<para>WARNING: Using the <option>swap</option>
|
||||
@ -318,13 +318,28 @@
|
||||
indefinitely (which is the default).</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>x-systemd.device-timeout=</option></term>
|
||||
|
||||
<listitem><para>Specifies how long
|
||||
systemd should wait for a device to
|
||||
show up before giving up on the
|
||||
entry. The argument is a time in
|
||||
seconds or explicitly specifified
|
||||
units of <literal>s</literal>,
|
||||
<literal>min</literal>,
|
||||
<literal>h</literal>,
|
||||
<literal>ms</literal>.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>tmp</option></term>
|
||||
|
||||
<listitem><para>The encrypted block device will
|
||||
be prepared for using it as <filename>/tmp</filename>;
|
||||
it will be formatted using
|
||||
<citerefentry><refentrytitle>mke2fs</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
<citerefentry project='man-pages'><refentrytitle>mke2fs</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
This option implies <option>plain</option>.</para>
|
||||
|
||||
<para>WARNING: Using the <option>tmp</option>
|
||||
@ -380,8 +395,8 @@ hidden /mnt/tc_hidden /dev/null tcrypt-hidden,tcrypt-keyfile
|
||||
<citerefentry><refentrytitle>systemd-cryptsetup@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>cryptsetup</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>mkswap</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>mke2fs</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<citerefentry project='man-pages'><refentrytitle>mkswap</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>mke2fs</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@ -24,7 +24,7 @@
|
||||
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>
|
||||
|
||||
<!-- translate man page references to links to html pages -->
|
||||
<xsl:template match="citerefentry">
|
||||
<xsl:template match="citerefentry[not(@project)]">
|
||||
<a>
|
||||
<xsl:attribute name="href">
|
||||
<xsl:value-of select="refentrytitle"/><xsl:text>.html</xsl:text>
|
||||
@ -33,6 +33,52 @@
|
||||
</a>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="citerefentry[@project='man-pages'] | citerefentry[manvolnum='2'] | citerefentry[manvolnum='4']">
|
||||
<a>
|
||||
<xsl:attribute name="href">
|
||||
<xsl:text>http://man7.org/linux/man-pages/man</xsl:text>
|
||||
<xsl:value-of select="manvolnum"/>
|
||||
<xsl:text>/</xsl:text>
|
||||
<xsl:value-of select="refentrytitle"/>
|
||||
<xsl:text>.</xsl:text>
|
||||
<xsl:value-of select="manvolnum"/>
|
||||
<xsl:text>.html</xsl:text>
|
||||
</xsl:attribute>
|
||||
<xsl:call-template name="inline.charseq"/>
|
||||
</a>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="citerefentry[@project='die-net']">
|
||||
<a>
|
||||
<xsl:attribute name="href">
|
||||
<xsl:text>http://linux.die.net/man/</xsl:text>
|
||||
<xsl:value-of select="manvolnum"/>
|
||||
<xsl:text>/</xsl:text>
|
||||
<xsl:value-of select="refentrytitle"/>
|
||||
</xsl:attribute>
|
||||
<xsl:call-template name="inline.charseq"/>
|
||||
</a>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="citerefentry[@project='archlinux']">
|
||||
<a>
|
||||
<xsl:attribute name="href">
|
||||
<xsl:text>https://www.archlinux.org/</xsl:text>
|
||||
<xsl:value-of select="refentrytitle"/>
|
||||
<xsl:text>/</xsl:text>
|
||||
<xsl:value-of select="refentrytitle"/>
|
||||
<xsl:text>.</xsl:text>
|
||||
<xsl:value-of select="manvolnum"/>
|
||||
<xsl:text>.html</xsl:text>
|
||||
</xsl:attribute>
|
||||
<xsl:call-template name="inline.charseq"/>
|
||||
</a>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="citerefentry[@project='gummiboot']">
|
||||
<xsl:call-template name="inline.charseq"/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="refsect1/title|refsect1/info/title">
|
||||
<!-- the ID is output in the block.object call for refsect1 -->
|
||||
<h2>
|
||||
|
||||
17
man/daemon.7
17
man/daemon.7
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "DAEMON" "7" "" "systemd 215" "daemon"
|
||||
.TH "DAEMON" "7" "" "systemd 217" "daemon"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -40,7 +40,8 @@ When a traditional SysV daemon starts, it should execute the following steps as
|
||||
Close all open file descriptors except standard input, output, and error (i\&.e\&. the first three file descriptors 0, 1, 2)\&. This ensures that no accidentally passed file descriptor stays around in the daemon process\&. On Linux, this is best implemented by iterating through
|
||||
/proc/self/fd, with a fallback of iterating from file descriptor 3 to the value returned by
|
||||
\fBgetrlimit()\fR
|
||||
for RLIMIT_NOFILE\&.
|
||||
for
|
||||
\fBRLIMIT_NOFILE\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
@ -51,7 +52,9 @@ for RLIMIT_NOFILE\&.
|
||||
.sp -1
|
||||
.IP " 2." 4.2
|
||||
.\}
|
||||
Reset all signal handlers to their default\&. This is best done by iterating through the available signals up to the limit of _NSIG and resetting them to
|
||||
Reset all signal handlers to their default\&. This is best done by iterating through the available signals up to the limit of
|
||||
\fB_NSIG\fR
|
||||
and resetting them to
|
||||
\fBSIG_DFL\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
@ -360,7 +363,9 @@ interface\&.
|
||||
Instead of using the
|
||||
\fBsyslog()\fR
|
||||
call to log directly to the system syslog service, a new\-style daemon may choose to simply log to standard error via
|
||||
\fBfprintf()\fR, which is then forwarded to syslog by the init system\&. If log priorities are necessary, these can be encoded by prefixing individual log lines with strings like "<4>" (for log priority 4 "WARNING" in the syslog priority scheme), following a similar style as the Linux kernel\*(Aqs
|
||||
\fBfprintf()\fR, which is then forwarded to syslog by the init system\&. If log priorities are necessary, these can be encoded by prefixing individual log lines with strings like
|
||||
"<4>"
|
||||
(for log priority 4 "WARNING" in the syslog priority scheme), following a similar style as the Linux kernel\*(Aqs
|
||||
\fBprintk()\fR
|
||||
priority system\&. For details, see
|
||||
\fBsd-daemon\fR(3)
|
||||
@ -462,7 +467,9 @@ units, as described in
|
||||
.PP
|
||||
Other forms of activation have been suggested and implemented in some systems\&. However, there are often simpler or better alternatives, or they can be put together of combinations of the schemes above\&. Example: Sometimes, it appears useful to start daemons or
|
||||
\&.socket
|
||||
units when a specific IP address is configured on a network interface, because network sockets shall be bound to the address\&. However, an alternative to implement this is by utilizing the Linux IP_FREEBIND socket option, as accessible via
|
||||
units when a specific IP address is configured on a network interface, because network sockets shall be bound to the address\&. However, an alternative to implement this is by utilizing the Linux
|
||||
\fBIP_FREEBIND\fR
|
||||
socket option, as accessible via
|
||||
\fIFreeBind=yes\fR
|
||||
in systemd socket files (see
|
||||
\fBsystemd.socket\fR(5)
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>daemon — Writing and packaging system daemons</p></div><div class="refsect1"><a name="idm214179512176"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>A daemon is a service process that runs in the
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="daemon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>daemon — Writing and packaging system daemons</p></div><div class="refsect1"><a name="idm214179837680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>A daemon is a service process that runs in the
|
||||
background and supervises the system or provides
|
||||
functionality to other processes. Traditionally,
|
||||
daemons are implemented following a scheme originating
|
||||
@ -29,7 +29,7 @@
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>. This
|
||||
manual page covers both schemes, and in
|
||||
particular includes recommendations for daemons that
|
||||
shall be included in the systemd init system.</p><div class="refsect2"><a name="idm214177063248"></a><h3 id="SysV Daemons">SysV Daemons<a class="headerlink" title="Permalink to this headline" href="#SysV%20Daemons">¶</a></h3><p>When a traditional SysV daemon
|
||||
shall be included in the systemd init system.</p><div class="refsect2"><a name="idm214176051712"></a><h3 id="SysV Daemons">SysV Daemons<a class="headerlink" title="Permalink to this headline" href="#SysV%20Daemons">¶</a></h3><p>When a traditional SysV daemon
|
||||
starts, it should execute the following steps
|
||||
as part of the initialization. Note that these
|
||||
steps are unnecessary for new-style daemons (see below),
|
||||
@ -46,11 +46,12 @@
|
||||
with a fallback of iterating from file
|
||||
descriptor 3 to the value returned by
|
||||
<code class="function">getrlimit()</code> for
|
||||
RLIMIT_NOFILE.</p></li><li class="listitem"><p>Reset all signal
|
||||
<code class="constant">RLIMIT_NOFILE</code>.
|
||||
</p></li><li class="listitem"><p>Reset all signal
|
||||
handlers to their default. This is
|
||||
best done by iterating through the
|
||||
available signals up to the limit of
|
||||
_NSIG and resetting them to
|
||||
<code class="constant">_NSIG</code> and resetting them to
|
||||
<code class="constant">SIG_DFL</code>.</p></li><li class="listitem"><p>Reset the signal mask
|
||||
using
|
||||
<code class="function">sigprocmask()</code>.</p></li><li class="listitem"><p>Sanitize the
|
||||
@ -125,7 +126,7 @@
|
||||
behavior optional and configurable via a
|
||||
command line argument to ease debugging as
|
||||
well as to simplify integration into systems
|
||||
using systemd.</p></div><div class="refsect2"><a name="idm214175728384"></a><h3 id="New-Style Daemons">New-Style Daemons<a class="headerlink" title="Permalink to this headline" href="#New-Style%20Daemons">¶</a></h3><p>Modern services for Linux should be
|
||||
using systemd.</p></div><div class="refsect2"><a name="idm214179921888"></a><h3 id="New-Style Daemons">New-Style Daemons<a class="headerlink" title="Permalink to this headline" href="#New-Style%20Daemons">¶</a></h3><p>Modern services for Linux should be
|
||||
implemented as new-style daemons. This makes it
|
||||
easier to supervise and control them at
|
||||
runtime and simplifies their
|
||||
@ -224,7 +225,7 @@
|
||||
init system. If log priorities are
|
||||
necessary, these can be encoded by
|
||||
prefixing individual log lines with
|
||||
strings like "<4>" (for log
|
||||
strings like "<code class="literal"><4></code>" (for log
|
||||
priority 4 "WARNING" in the syslog
|
||||
priority scheme), following a similar
|
||||
style as the Linux kernel's
|
||||
@ -234,7 +235,7 @@
|
||||
and
|
||||
<a href="systemd.exec.html"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>.</p></li></ol></div><p>These recommendations are similar but
|
||||
not identical to the <a class="ulink" href="https://developer.apple.com/library/mac/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html" target="_top">Apple
|
||||
MacOS X Daemon Requirements</a>.</p></div></div><div class="refsect1"><a name="idm214178358368"></a><h2 id="Activation">Activation<a class="headerlink" title="Permalink to this headline" href="#Activation">¶</a></h2><p>New-style init systems provide multiple
|
||||
MacOS X Daemon Requirements</a>.</p></div></div><div class="refsect1"><a name="idm214174974720"></a><h2 id="Activation">Activation<a class="headerlink" title="Permalink to this headline" href="#Activation">¶</a></h2><p>New-style init systems provide multiple
|
||||
additional mechanisms to activate services, as
|
||||
detailed below. It is common that services are
|
||||
configured to be activated via more than one mechanism
|
||||
@ -258,7 +259,7 @@
|
||||
request is lost because client requests will be queued
|
||||
by the bus system (in case of D-Bus) or the kernel (in
|
||||
case of sockets) until the activation is
|
||||
completed.</p><div class="refsect2"><a name="idm214177474608"></a><h3 id="Activation on Boot">Activation on Boot<a class="headerlink" title="Permalink to this headline" href="#Activation%20on%20Boot">¶</a></h3><p>Old-style daemons are usually activated
|
||||
completed.</p><div class="refsect2"><a name="idm214174971488"></a><h3 id="Activation on Boot">Activation on Boot<a class="headerlink" title="Permalink to this headline" href="#Activation%20on%20Boot">¶</a></h3><p>Old-style daemons are usually activated
|
||||
exclusively on boot (and manually by the
|
||||
administrator) via SysV init scripts, as
|
||||
detailed in the <a class="ulink" href="http://refspecs.linuxbase.org/LSB_3.1.1/LSB-Core-generic/LSB-Core-generic/iniscrptact.html" target="_top">LSB
|
||||
@ -286,7 +287,7 @@
|
||||
for details about the
|
||||
<code class="filename">.wants/</code> directories, and
|
||||
<a href="systemd.special.html"><span class="citerefentry"><span class="refentrytitle">systemd.special</span>(7)</span></a>
|
||||
for details about the two boot targets.</p></div><div class="refsect2"><a name="idm214175963792"></a><h3 id="Socket-Based Activation">Socket-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Socket-Based%20Activation">¶</a></h3><p>In order to maximize the possible
|
||||
for details about the two boot targets.</p></div><div class="refsect2"><a name="idm214174963776"></a><h3 id="Socket-Based Activation">Socket-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Socket-Based%20Activation">¶</a></h3><p>In order to maximize the possible
|
||||
parallelization and robustness and simplify
|
||||
configuration and development, it is
|
||||
recommended for all new-style daemons that
|
||||
@ -357,7 +358,7 @@
|
||||
example from
|
||||
<code class="filename">multi-user.target</code> or
|
||||
suchlike) when one is installed in
|
||||
<code class="filename">sockets.target</code>.</p></div><div class="refsect2"><a name="idm214176756752"></a><h3 id="Bus-Based Activation">Bus-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Bus-Based%20Activation">¶</a></h3><p>When the D-Bus IPC system is used for
|
||||
<code class="filename">sockets.target</code>.</p></div><div class="refsect2"><a name="idm214174948384"></a><h3 id="Bus-Based Activation">Bus-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Bus-Based%20Activation">¶</a></h3><p>When the D-Bus IPC system is used for
|
||||
communication with clients, new-style daemons
|
||||
should employ bus activation so that they are
|
||||
automatically activated when a client
|
||||
@ -380,7 +381,7 @@
|
||||
<code class="filename">rtkit-daemon.service</code>. This
|
||||
is needed to make sure that the daemon is
|
||||
started in a race-free fashion when activated
|
||||
via multiple mechanisms simultaneously.</p></div><div class="refsect2"><a name="idm214178044384"></a><h3 id="Device-Based Activation">Device-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Device-Based%20Activation">¶</a></h3><p>Often, daemons that manage a particular
|
||||
via multiple mechanisms simultaneously.</p></div><div class="refsect2"><a name="idm214174943904"></a><h3 id="Device-Based Activation">Device-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Device-Based%20Activation">¶</a></h3><p>Often, daemons that manage a particular
|
||||
type of hardware should be activated only when
|
||||
the hardware of the respective kind is plugged
|
||||
in or otherwise becomes available. In a
|
||||
@ -416,7 +417,7 @@
|
||||
<span class="command"><strong>enable</strong></span> of
|
||||
<a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>
|
||||
instead of manipulating the udev
|
||||
ruleset.</p></div><div class="refsect2"><a name="idm214178026080"></a><h3 id="Path-Based Activation">Path-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Path-Based%20Activation">¶</a></h3><p>Often, runtime of daemons processing
|
||||
ruleset.</p></div><div class="refsect2"><a name="idm214174935040"></a><h3 id="Path-Based Activation">Path-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Path-Based%20Activation">¶</a></h3><p>Often, runtime of daemons processing
|
||||
spool files or directories (such as a printing
|
||||
system) can be delayed until these file system
|
||||
objects change state, or become
|
||||
@ -426,13 +427,13 @@
|
||||
path-based activation configured in
|
||||
<code class="filename">.path</code> units, as outlined
|
||||
in
|
||||
<a href="systemd.path.html"><span class="citerefentry"><span class="refentrytitle">systemd.path</span>(5)</span></a>.</p></div><div class="refsect2"><a name="idm214176776224"></a><h3 id="Timer-Based Activation">Timer-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Timer-Based%20Activation">¶</a></h3><p>Some daemons that implement clean-up
|
||||
<a href="systemd.path.html"><span class="citerefentry"><span class="refentrytitle">systemd.path</span>(5)</span></a>.</p></div><div class="refsect2"><a name="idm214174931872"></a><h3 id="Timer-Based Activation">Timer-Based Activation<a class="headerlink" title="Permalink to this headline" href="#Timer-Based%20Activation">¶</a></h3><p>Some daemons that implement clean-up
|
||||
jobs that are intended to be executed in
|
||||
regular intervals benefit from timer-based
|
||||
activation. In systemd, this is implemented
|
||||
via <code class="filename">.timer</code> units, as
|
||||
described in
|
||||
<a href="systemd.timer.html"><span class="citerefentry"><span class="refentrytitle">systemd.timer</span>(5)</span></a>.</p></div><div class="refsect2"><a name="idm214176252752"></a><h3 id="Other Forms of Activation">Other Forms of Activation<a class="headerlink" title="Permalink to this headline" href="#Other%20Forms%20of%20Activation">¶</a></h3><p>Other forms of activation have been
|
||||
<a href="systemd.timer.html"><span class="citerefentry"><span class="refentrytitle">systemd.timer</span>(5)</span></a>.</p></div><div class="refsect2"><a name="idm214174928944"></a><h3 id="Other Forms of Activation">Other Forms of Activation<a class="headerlink" title="Permalink to this headline" href="#Other%20Forms%20of%20Activation">¶</a></h3><p>Other forms of activation have been
|
||||
suggested and implemented in some
|
||||
systems. However, there are often simpler or
|
||||
better alternatives, or they can be put
|
||||
@ -443,7 +444,7 @@
|
||||
on a network interface, because network
|
||||
sockets shall be bound to the
|
||||
address. However, an alternative to implement
|
||||
this is by utilizing the Linux IP_FREEBIND
|
||||
this is by utilizing the Linux <code class="constant">IP_FREEBIND</code>
|
||||
socket option, as accessible via
|
||||
<code class="varname">FreeBind=yes</code> in systemd
|
||||
socket files (see
|
||||
@ -477,7 +478,7 @@
|
||||
activation to schedule background jobs during
|
||||
runtime and with minimal impact on the system,
|
||||
and remove it from the boot phase
|
||||
itself.</p></div></div><div class="refsect1"><a name="idm214176372608"></a><h2 id="Integration with Systemd">Integration with Systemd<a class="headerlink" title="Permalink to this headline" href="#Integration%20with%20Systemd">¶</a></h2><div class="refsect2"><a name="idm214178809840"></a><h3 id="Writing Systemd Unit Files">Writing Systemd Unit Files<a class="headerlink" title="Permalink to this headline" href="#Writing%20Systemd%20Unit%20Files">¶</a></h3><p>When writing systemd unit files, it is
|
||||
itself.</p></div></div><div class="refsect1"><a name="idm214174920464"></a><h2 id="Integration with Systemd">Integration with Systemd<a class="headerlink" title="Permalink to this headline" href="#Integration%20with%20Systemd">¶</a></h2><div class="refsect2"><a name="idm214174919824"></a><h3 id="Writing Systemd Unit Files">Writing Systemd Unit Files<a class="headerlink" title="Permalink to this headline" href="#Writing%20Systemd%20Unit%20Files">¶</a></h3><p>When writing systemd unit files, it is
|
||||
recommended to consider the following
|
||||
suggestions:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>If possible, do not use
|
||||
the <code class="varname">Type=forking</code>
|
||||
@ -526,7 +527,7 @@
|
||||
your service file
|
||||
<code class="filename">foo.service</code>, for
|
||||
a hypothetical program
|
||||
<code class="filename">foo</code>.</p></li></ol></div></div><div class="refsect2"><a name="idm214177358624"></a><h3 id="Installing Systemd Service Files">Installing Systemd Service Files<a class="headerlink" title="Permalink to this headline" href="#Installing%20Systemd%20Service%20Files">¶</a></h3><p>At the build installation time
|
||||
<code class="filename">foo</code>.</p></li></ol></div></div><div class="refsect2"><a name="idm214174904272"></a><h3 id="Installing Systemd Service Files">Installing Systemd Service Files<a class="headerlink" title="Permalink to this headline" href="#Installing%20Systemd%20Service%20Files">¶</a></h3><p>At the build installation time
|
||||
(e.g. <span class="command"><strong>make install</strong></span> during
|
||||
package build), packages are recommended to
|
||||
install their systemd unit files in the
|
||||
@ -548,7 +549,7 @@
|
||||
<a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>
|
||||
tool to activate them automatically on
|
||||
boot.</p><p>Packages using
|
||||
<a href="autoconf.html"><span class="citerefentry"><span class="refentrytitle">autoconf</span>(1)</span></a>
|
||||
<a href="http://linux.die.net/man/1/autoconf"><span class="citerefentry"><span class="refentrytitle">autoconf</span>(1)</span></a>
|
||||
are recommended to use a configure script
|
||||
excerpt like the following to determine the
|
||||
unit installation path during source
|
||||
@ -577,14 +578,14 @@ AM_CONDITIONAL([HAVE_SYSTEMD], [test "x$with_systemdsystemunitdir" != "xno"])</p
|
||||
work, it is recommended to add the following
|
||||
to the top-level <code class="filename">Makefile.am</code>
|
||||
file in
|
||||
<a href="automake.html"><span class="citerefentry"><span class="refentrytitle">automake</span>(1)</span></a>-based
|
||||
<a href="http://linux.die.net/man/1/automake"><span class="citerefentry"><span class="refentrytitle">automake</span>(1)</span></a>-based
|
||||
projects:</p><pre class="programlisting">DISTCHECK_CONFIGURE_FLAGS = \
|
||||
--with-systemdsystemunitdir=$$dc_install_base/$(systemdsystemunitdir)</pre><p>Finally, unit files should be installed in the system with an automake excerpt like the following:</p><pre class="programlisting">if HAVE_SYSTEMD
|
||||
systemdsystemunit_DATA = \
|
||||
foobar.socket \
|
||||
foobar.service
|
||||
endif</pre><p>In the
|
||||
<a href="rpm.html"><span class="citerefentry"><span class="refentrytitle">rpm</span>(8)</span></a>
|
||||
<a href="http://linux.die.net/man/8/rpm"><span class="citerefentry"><span class="refentrytitle">rpm</span>(8)</span></a>
|
||||
<code class="filename">.spec</code> file, use snippets
|
||||
like the following to enable/disable the
|
||||
service during
|
||||
@ -631,7 +632,7 @@ fi</pre><p>Where 0.47.11-1 is the first package
|
||||
specific to Fedora which can be used to check
|
||||
whether a SysV init script is enabled. Other
|
||||
operating systems will have to use different
|
||||
commands here.</p></div></div><div class="refsect1"><a name="idm214178311488"></a><h2 id="Porting Existing Daemons">Porting Existing Daemons<a class="headerlink" title="Permalink to this headline" href="#Porting%20Existing%20Daemons">¶</a></h2><p>Since new-style init systems such as systemd are
|
||||
commands here.</p></div></div><div class="refsect1"><a name="idm214174874928"></a><h2 id="Porting Existing Daemons">Porting Existing Daemons<a class="headerlink" title="Permalink to this headline" href="#Porting%20Existing%20Daemons">¶</a></h2><p>Since new-style init systems such as systemd are
|
||||
compatible with traditional SysV init systems, it is
|
||||
not strictly necessary to port existing daemons to the
|
||||
new style. However, doing so offers additional
|
||||
@ -676,9 +677,9 @@ fi</pre><p>Where 0.47.11-1 is the first package
|
||||
details.</p></li><li class="listitem"><p>If the daemon exposes
|
||||
interfaces via D-Bus, write and install a
|
||||
D-Bus activation file for the service, see
|
||||
above for details.</p></li></ol></div></div><div class="refsect1"><a name="idm214180581568"></a><h2 id="Placing Daemon Data">Placing Daemon Data<a class="headerlink" title="Permalink to this headline" href="#Placing%20Daemon%20Data">¶</a></h2><p>It is recommended to follow the general
|
||||
above for details.</p></li></ol></div></div><div class="refsect1"><a name="idm214174864432"></a><h2 id="Placing Daemon Data">Placing Daemon Data<a class="headerlink" title="Permalink to this headline" href="#Placing%20Daemon%20Data">¶</a></h2><p>It is recommended to follow the general
|
||||
guidelines for placing package files, as discussed in
|
||||
<a href="file-hierarchy.html"><span class="citerefentry"><span class="refentrytitle">file-hierarchy</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm214180579440"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="file-hierarchy.html"><span class="citerefentry"><span class="refentrytitle">file-hierarchy</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm214174862368"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sd-daemon.html"><span class="citerefentry"><span class="refentrytitle">sd-daemon</span>(3)</span></a>,
|
||||
<a href="sd_listen_fds.html"><span class="citerefentry"><span class="refentrytitle">sd_listen_fds</span>(3)</span></a>,
|
||||
|
||||
@ -85,13 +85,14 @@
|
||||
with a fallback of iterating from file
|
||||
descriptor 3 to the value returned by
|
||||
<function>getrlimit()</function> for
|
||||
RLIMIT_NOFILE.</para></listitem>
|
||||
<constant>RLIMIT_NOFILE</constant>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>Reset all signal
|
||||
handlers to their default. This is
|
||||
best done by iterating through the
|
||||
available signals up to the limit of
|
||||
_NSIG and resetting them to
|
||||
<constant>_NSIG</constant> and resetting them to
|
||||
<constant>SIG_DFL</constant>.</para></listitem>
|
||||
|
||||
<listitem><para>Reset the signal mask
|
||||
@ -330,7 +331,7 @@
|
||||
init system. If log priorities are
|
||||
necessary, these can be encoded by
|
||||
prefixing individual log lines with
|
||||
strings like "<4>" (for log
|
||||
strings like <literal><4></literal> (for log
|
||||
priority 4 "WARNING" in the syslog
|
||||
priority scheme), following a similar
|
||||
style as the Linux kernel's
|
||||
@ -610,7 +611,7 @@
|
||||
on a network interface, because network
|
||||
sockets shall be bound to the
|
||||
address. However, an alternative to implement
|
||||
this is by utilizing the Linux IP_FREEBIND
|
||||
this is by utilizing the Linux <constant>IP_FREEBIND</constant>
|
||||
socket option, as accessible via
|
||||
<varname>FreeBind=yes</varname> in systemd
|
||||
socket files (see
|
||||
@ -748,7 +749,7 @@
|
||||
boot.</para>
|
||||
|
||||
<para>Packages using
|
||||
<citerefentry><refentrytitle>autoconf</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
<citerefentry project='die-net'><refentrytitle>autoconf</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
are recommended to use a configure script
|
||||
excerpt like the following to determine the
|
||||
unit installation path during source
|
||||
@ -783,7 +784,7 @@ AM_CONDITIONAL([HAVE_SYSTEMD], [test "x$with_systemdsystemunitdir" != "xno"])</p
|
||||
work, it is recommended to add the following
|
||||
to the top-level <filename>Makefile.am</filename>
|
||||
file in
|
||||
<citerefentry><refentrytitle>automake</refentrytitle><manvolnum>1</manvolnum></citerefentry>-based
|
||||
<citerefentry project='die-net'><refentrytitle>automake</refentrytitle><manvolnum>1</manvolnum></citerefentry>-based
|
||||
projects:</para>
|
||||
|
||||
<programlisting>DISTCHECK_CONFIGURE_FLAGS = \
|
||||
@ -798,7 +799,7 @@ systemdsystemunit_DATA = \
|
||||
endif</programlisting>
|
||||
|
||||
<para>In the
|
||||
<citerefentry><refentrytitle>rpm</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<citerefentry project='die-net'><refentrytitle>rpm</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<filename>.spec</filename> file, use snippets
|
||||
like the following to enable/disable the
|
||||
service during
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "FILE\-HIERARCHY" "7" "" "systemd 215" "file-hierarchy"
|
||||
.TH "FILE\-HIERARCHY" "7" "" "systemd 217" "file-hierarchy"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -87,6 +87,8 @@ set they should prefer using the directory specified in it over directly referen
|
||||
/tmp
|
||||
(see
|
||||
\fBenviron\fR(7)
|
||||
and
|
||||
\m[blue]\fBIEEE Std 1003\&.1\fR\m[]\&\s-2\u[2]\d\s+2
|
||||
for details)\&.
|
||||
.RE
|
||||
.SH "RUNTIME DATA"
|
||||
@ -112,7 +114,7 @@ Contains per\-user runtime directories, each usually individually mounted
|
||||
instances\&. Always writable, flushed at each reboot and when the user logs out\&. User code should not reference this directory directly, but via the
|
||||
\fI$XDG_RUNTIME_DIR\fR
|
||||
environment variable, as documented in the
|
||||
\m[blue]\fBXDG Base Directory Specification\fR\m[]\&\s-2\u[2]\d\s+2\&.
|
||||
\m[blue]\fBXDG Base Directory Specification\fR\m[]\&\s-2\u[3]\d\s+2\&.
|
||||
.RE
|
||||
.SH "VENDOR-SUPPLIED OPERATING SYSTEM RESOURCES"
|
||||
.PP
|
||||
@ -146,7 +148,7 @@ Static, private vendor data that is compatible with all architectures (though no
|
||||
.RS 4
|
||||
Location for placing dynamic libraries, also called
|
||||
\fI$libdir\fR\&. The architecture identifier to use is defined on
|
||||
\m[blue]\fBMultiarch Architecture Specifiers (Tuples)\fR\m[]\&\s-2\u[3]\d\s+2
|
||||
\m[blue]\fBMultiarch Architecture Specifiers (Tuples)\fR\m[]\&\s-2\u[4]\d\s+2
|
||||
list\&. Legacy locations of
|
||||
\fI$libdir\fR
|
||||
are
|
||||
@ -321,8 +323,8 @@ This compatibility symlink points to
|
||||
.SH "HOME DIRECTORY"
|
||||
.PP
|
||||
User applications may want to place files and directories in the user\*(Aqs home directory\&. They should follow the following basic structure\&. Note that some of these directories are also standardized (though more weakly) by the
|
||||
\m[blue]\fBXDG Base Directory Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. Additional locations for high\-level user resources are defined by
|
||||
\m[blue]\fBxdg\-user\-dirs\fR\m[]\&\s-2\u[4]\d\s+2\&.
|
||||
\m[blue]\fBXDG Base Directory Specification\fR\m[]\&\s-2\u[3]\d\s+2\&. Additional locations for high\-level user resources are defined by
|
||||
\m[blue]\fBxdg\-user\-dirs\fR\m[]\&\s-2\u[5]\d\s+2\&.
|
||||
.PP
|
||||
~/\&.cache
|
||||
.RS 4
|
||||
@ -355,7 +357,7 @@ Static, private vendor data that is compatible with all architectures\&.
|
||||
~/\&.local/lib/\fIarch\-id\fR
|
||||
.RS 4
|
||||
Location for placing public dynamic libraries\&. The architecture identifier to use, is defined on
|
||||
\m[blue]\fBMultiarch Architecture Specifiers (Tuples)\fR\m[]\&\s-2\u[3]\d\s+2
|
||||
\m[blue]\fBMultiarch Architecture Specifiers (Tuples)\fR\m[]\&\s-2\u[4]\d\s+2
|
||||
list\&.
|
||||
.RE
|
||||
.PP
|
||||
@ -554,7 +556,7 @@ T}
|
||||
T{
|
||||
~/\&.local/lib/\fIpackage\fR
|
||||
T}:T{
|
||||
Private, static vendor resources of the package, compatible wih any architecture, or any other kind of read\-only vendor data\&.
|
||||
Private, static vendor resources of the package, compatible with any architecture, or any other kind of read\-only vendor data\&.
|
||||
T}
|
||||
T{
|
||||
~/\&.local/lib/\fIarch\-id\fR/\fIpackage\fR
|
||||
@ -621,16 +623,21 @@ File System Hierarchy
|
||||
\%http://refspecs.linuxfoundation.org/FHS_2.3/fhs-2.3.html
|
||||
.RE
|
||||
.IP " 2." 4
|
||||
IEEE Std 1003.1
|
||||
.RS 4
|
||||
\%http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap08.html#tag_08_03
|
||||
.RE
|
||||
.IP " 3." 4
|
||||
XDG Base Directory Specification
|
||||
.RS 4
|
||||
\%http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
|
||||
.RE
|
||||
.IP " 3." 4
|
||||
.IP " 4." 4
|
||||
Multiarch Architecture Specifiers (Tuples)
|
||||
.RS 4
|
||||
\%https://wiki.debian.org/Multiarch/Tuples
|
||||
.RE
|
||||
.IP " 4." 4
|
||||
.IP " 5." 4
|
||||
xdg-user-dirs
|
||||
.RS 4
|
||||
\%http://www.freedesktop.org/wiki/Software/xdg-user-dirs/
|
||||
|
||||
@ -19,20 +19,20 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="file-hierarchy"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>file-hierarchy — File system hierarchy overview</p></div><div class="refsect1"><a name="idm214174576496"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>Operating systems using the
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="file-hierarchy"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>file-hierarchy — File system hierarchy overview</p></div><div class="refsect1"><a name="idm214179616496"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>Operating systems using the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
system and service manager are organized based on a
|
||||
file system hierarchy inspired by UNIX, more
|
||||
specifically the hierarchy described in the <a class="ulink" href="http://refspecs.linuxfoundation.org/FHS_2.3/fhs-2.3.html" target="_top">File
|
||||
System Hierarchy</a> specification and
|
||||
<a href="hier.html"><span class="citerefentry"><span class="refentrytitle">hier</span>(7)</span></a>. This
|
||||
<a href="http://man7.org/linux/man-pages/man7/hier.7.html"><span class="citerefentry"><span class="refentrytitle">hier</span>(7)</span></a>. This
|
||||
manual page describes a more minimal, modernized
|
||||
subset of these specifications that defines more
|
||||
strictly the suggestions and restrictions systemd
|
||||
makes on the file system hierarchy.</p><p>Many of the paths described here are queriable
|
||||
with the
|
||||
<a href="systemd-path.html"><span class="citerefentry"><span class="refentrytitle">systemd-path</span>(1)</span></a>
|
||||
tool.</p></div><div class="refsect1"><a name="idm214173152608"></a><h2 id="General Structure">General Structure<a class="headerlink" title="Permalink to this headline" href="#General%20Structure">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/"><span class="term"><code class="filename">/</code></span><a class="headerlink" title="Permalink to this term" href="#/">¶</a></dt><dd><p>The file system
|
||||
tool.</p></div><div class="refsect1"><a name="idm214175827696"></a><h2 id="General Structure">General Structure<a class="headerlink" title="Permalink to this headline" href="#General%20Structure">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/"><span class="term"><code class="filename">/</code></span><a class="headerlink" title="Permalink to this term" href="#/">¶</a></dt><dd><p>The file system
|
||||
root. Usually writable, but this is
|
||||
not required. Possibly a temporary
|
||||
file system ("<code class="literal">tmpfs</code>"). Not shared with
|
||||
@ -105,8 +105,8 @@
|
||||
accessible to other users of the
|
||||
system it is essential that this
|
||||
directory is only written to with the
|
||||
<a href="mkstemp.html"><span class="citerefentry"><span class="refentrytitle">mkstemp</span>(3)</span></a>,
|
||||
<a href="mkdtemp.html"><span class="citerefentry"><span class="refentrytitle">mkdtemp</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/mkstemp.3.html"><span class="citerefentry"><span class="refentrytitle">mkstemp</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/mkdtemp.3.html"><span class="citerefentry"><span class="refentrytitle">mkdtemp</span>(3)</span></a>
|
||||
and related calls. This directory is
|
||||
usually flushed at boot-up. Also,
|
||||
files that are not accessed within a
|
||||
@ -117,7 +117,9 @@
|
||||
should prefer using the directory
|
||||
specified in it over directly
|
||||
referencing
|
||||
<code class="filename">/tmp</code> (see <a href="environ.html"><span class="citerefentry"><span class="refentrytitle">environ</span>(7)</span></a> for details).</p></dd></dl></div></div><div class="refsect1"><a name="idm214170719280"></a><h2 id="Runtime Data">Runtime Data<a class="headerlink" title="Permalink to this headline" href="#Runtime%20Data">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/run"><span class="term"><code class="filename">/run</code></span><a class="headerlink" title="Permalink to this term" href="#/run">¶</a></dt><dd><p>A
|
||||
<code class="filename">/tmp</code> (see <a href="http://man7.org/linux/man-pages/man7/environ.7.html"><span class="citerefentry"><span class="refentrytitle">environ</span>(7)</span></a>
|
||||
and
|
||||
<a class="ulink" href="http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap08.html#tag_08_03" target="_top">IEEE Std 1003.1</a> for details).</p></dd></dl></div></div><div class="refsect1"><a name="idm214179691648"></a><h2 id="Runtime Data">Runtime Data<a class="headerlink" title="Permalink to this headline" href="#Runtime%20Data">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/run"><span class="term"><code class="filename">/run</code></span><a class="headerlink" title="Permalink to this term" href="#/run">¶</a></dt><dd><p>A
|
||||
"<code class="literal">tmpfs</code>" file system
|
||||
for system packages to place runtime
|
||||
data in. This directory is flushed on
|
||||
@ -141,7 +143,7 @@
|
||||
environment variable, as documented in
|
||||
the <a class="ulink" href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html" target="_top">XDG
|
||||
Base Directory
|
||||
Specification</a>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214174010496"></a><h2 id="Vendor-supplied Operating System Resources">Vendor-supplied Operating System Resources<a class="headerlink" title="Permalink to this headline" href="#Vendor-supplied%20Operating%20System%20Resources">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/usr"><span class="term"><code class="filename">/usr</code></span><a class="headerlink" title="Permalink to this term" href="#/usr">¶</a></dt><dd><p>Vendor-supplied
|
||||
Specification</a>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214179680832"></a><h2 id="Vendor-supplied Operating System Resources">Vendor-supplied Operating System Resources<a class="headerlink" title="Permalink to this headline" href="#Vendor-supplied%20Operating%20System%20Resources">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/usr"><span class="term"><code class="filename">/usr</code></span><a class="headerlink" title="Permalink to this term" href="#/usr">¶</a></dt><dd><p>Vendor-supplied
|
||||
operating system resources. Usually
|
||||
read-only, but this is not
|
||||
required. Possibly shared between
|
||||
@ -213,7 +215,7 @@
|
||||
but for vendor versions of files in
|
||||
the variable, persistent data
|
||||
directory
|
||||
<code class="filename">/var</code>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214171094480"></a><h2 id="Persistent Variable System Data">Persistent Variable System Data<a class="headerlink" title="Permalink to this headline" href="#Persistent%20Variable%20System%20Data">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/var"><span class="term"><code class="filename">/var</code></span><a class="headerlink" title="Permalink to this term" href="#/var">¶</a></dt><dd><p>Persistent, variable
|
||||
<code class="filename">/var</code>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214174739888"></a><h2 id="Persistent Variable System Data">Persistent Variable System Data<a class="headerlink" title="Permalink to this headline" href="#Persistent%20Variable%20System%20Data">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/var"><span class="term"><code class="filename">/var</code></span><a class="headerlink" title="Permalink to this term" href="#/var">¶</a></dt><dd><p>Persistent, variable
|
||||
system data. Must be writable. This
|
||||
directory might be pre-populated with
|
||||
vendor-supplied data, but applications
|
||||
@ -244,7 +246,7 @@
|
||||
private logs in this directory, though
|
||||
it is recommended to do most logging
|
||||
via the
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
and
|
||||
<a href="sd_journal_print.html"><span class="citerefentry"><span class="refentrytitle">sd_journal_print</span>(3)</span></a>
|
||||
calls.</p></dd><dt id="/var/spool"><span class="term"><code class="filename">/var/spool</code></span><a class="headerlink" title="Permalink to this term" href="#/var/spool">¶</a></dt><dd><p>Persistent system
|
||||
@ -264,8 +266,8 @@
|
||||
restrictions as with
|
||||
<code class="filename">/tmp</code> apply, and
|
||||
hence only
|
||||
<a href="mkstemp.html"><span class="citerefentry"><span class="refentrytitle">mkstemp</span>(3)</span></a>,
|
||||
<a href="mkdtemp.html"><span class="citerefentry"><span class="refentrytitle">mkdtemp</span>(3)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man3/mkstemp.3.html"><span class="citerefentry"><span class="refentrytitle">mkstemp</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/mkdtemp.3.html"><span class="citerefentry"><span class="refentrytitle">mkdtemp</span>(3)</span></a>
|
||||
or similar calls should be used to
|
||||
make use of this directory. If
|
||||
applications find the environment
|
||||
@ -273,8 +275,9 @@
|
||||
set they should prefer using the
|
||||
directory specified in it over
|
||||
directly referencing
|
||||
<code class="filename">/var/tmp</code> (see <a href="environ.html"><span class="citerefentry"><span class="refentrytitle">environ</span>(7)</span></a> for details).
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214172285296"></a><h2 id="Virtual Kernel and API File Systems">Virtual Kernel and API File Systems<a class="headerlink" title="Permalink to this headline" href="#Virtual%20Kernel%20and%20API%20File%20Systems">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/dev"><span class="term"><code class="filename">/dev</code></span><a class="headerlink" title="Permalink to this term" href="#/dev">¶</a></dt><dd><p>The root directory for
|
||||
<code class="filename">/var/tmp</code> (see <a href="http://man7.org/linux/man-pages/man7/environ.7.html"><span class="citerefentry"><span class="refentrytitle">environ</span>(7)</span></a>
|
||||
for details).
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214174717600"></a><h2 id="Virtual Kernel and API File Systems">Virtual Kernel and API File Systems<a class="headerlink" title="Permalink to this headline" href="#Virtual%20Kernel%20and%20API%20File%20Systems">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/dev"><span class="term"><code class="filename">/dev</code></span><a class="headerlink" title="Permalink to this term" href="#/dev">¶</a></dt><dd><p>The root directory for
|
||||
device nodes. Usually this directory
|
||||
is mounted as a
|
||||
"<code class="literal">devtmpfs</code>" instance,
|
||||
@ -314,7 +317,7 @@
|
||||
is mostly an API to interface with the
|
||||
kernel and not a place where normal
|
||||
files may be stored. For details, see
|
||||
<a href="proc.html"><span class="citerefentry"><span class="refentrytitle">proc</span>(5)</span></a>. A
|
||||
<a href="http://man7.org/linux/man-pages/man5/proc.5.html"><span class="citerefentry"><span class="refentrytitle">proc</span>(5)</span></a>. A
|
||||
number of special purpose virtual file
|
||||
systems might be mounted below this
|
||||
directory.</p></dd><dt id="/proc/sys"><span class="term"><code class="filename">/proc/sys</code></span><a class="headerlink" title="Permalink to this term" href="#/proc/sys">¶</a></dt><dd><p>A hierarchy below
|
||||
@ -337,7 +340,7 @@
|
||||
read-only. A number of special purpose
|
||||
virtual file systems might be mounted
|
||||
below this
|
||||
directory.</p></dd></dl></div></div><div class="refsect1"><a name="idm214170710752"></a><h2 id="Compatibility Symlinks">Compatibility Symlinks<a class="headerlink" title="Permalink to this headline" href="#Compatibility%20Symlinks">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/bin"><span class="term"><code class="filename">/bin</code>, </span><span class="term"><code class="filename">/sbin</code>, </span><span class="term"><code class="filename">/usr/sbin</code></span><a class="headerlink" title="Permalink to this term" href="#/bin">¶</a></dt><dd><p>These compatibility
|
||||
directory.</p></dd></dl></div></div><div class="refsect1"><a name="idm214174697984"></a><h2 id="Compatibility Symlinks">Compatibility Symlinks<a class="headerlink" title="Permalink to this headline" href="#Compatibility%20Symlinks">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/bin"><span class="term"><code class="filename">/bin</code>, </span><span class="term"><code class="filename">/sbin</code>, </span><span class="term"><code class="filename">/usr/sbin</code></span><a class="headerlink" title="Permalink to this term" href="#/bin">¶</a></dt><dd><p>These compatibility
|
||||
symlinks point to
|
||||
<code class="filename">/usr/bin</code>,
|
||||
ensuring that scripts and binaries
|
||||
@ -360,7 +363,7 @@
|
||||
<code class="filename">/run</code>, ensuring
|
||||
that programs referencing this legacy
|
||||
path correctly find their runtime
|
||||
data.</p></dd></dl></div></div><div class="refsect1"><a name="idm214172491616"></a><h2 id="Home Directory">Home Directory<a class="headerlink" title="Permalink to this headline" href="#Home%20Directory">¶</a></h2><p>User applications may want to place files and
|
||||
data.</p></dd></dl></div></div><div class="refsect1"><a name="idm214174685008"></a><h2 id="Home Directory">Home Directory<a class="headerlink" title="Permalink to this headline" href="#Home%20Directory">¶</a></h2><p>User applications may want to place files and
|
||||
directories in the user's home directory. They should
|
||||
follow the following basic structure. Note that some
|
||||
of these directories are also standardized (though
|
||||
@ -420,7 +423,7 @@
|
||||
<code class="varname">$XDG_DATA_HOME</code> set
|
||||
is should use the directory specified
|
||||
in it instead of this
|
||||
directory.</p></dd></dl></div></div><div class="refsect1"><a name="idm214175546688"></a><h2 id="Unprivileged Write Access">Unprivileged Write Access<a class="headerlink" title="Permalink to this headline" href="#Unprivileged%20Write%20Access">¶</a></h2><p>Unprivileged processes generally lack
|
||||
directory.</p></dd></dl></div></div><div class="refsect1"><a name="idm214174656944"></a><h2 id="Unprivileged Write Access">Unprivileged Write Access<a class="headerlink" title="Permalink to this headline" href="#Unprivileged%20Write%20Access">¶</a></h2><p>Unprivileged processes generally lack
|
||||
write access to most of the hierarchy.</p><p>The exceptions for normal users are
|
||||
<code class="filename">/tmp</code>,
|
||||
<code class="filename">/var/tmp</code>,
|
||||
@ -443,7 +446,7 @@
|
||||
<code class="varname">RuntimeDirectory=</code> directive of
|
||||
service units (see
|
||||
<a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>
|
||||
for details).</p></div><div class="refsect1"><a name="idm214173794992"></a><h2 id="Node Types">Node Types<a class="headerlink" title="Permalink to this headline" href="#Node%20Types">¶</a></h2><p>Unix file systems support different types of file
|
||||
for details).</p></div><div class="refsect1"><a name="idm214174645504"></a><h2 id="Node Types">Node Types<a class="headerlink" title="Permalink to this headline" href="#Node%20Types">¶</a></h2><p>Unix file systems support different types of file
|
||||
nodes, including regular files, directories, symlinks,
|
||||
character and block device nodes, sockets and FIFOs.</p><p>It is strongly recommended that
|
||||
<code class="filename">/dev</code> is the only location below
|
||||
@ -451,15 +454,15 @@
|
||||
<code class="filename">/run</code> shall be the only location
|
||||
to place sockets and FIFOs. Regular files,
|
||||
directories and symlinks may be used in all
|
||||
directories.</p></div><div class="refsect1"><a name="idm214173791552"></a><h2 id="System Packages">System Packages<a class="headerlink" title="Permalink to this headline" href="#System%20Packages">¶</a></h2><p>Developers of system packages should follow
|
||||
directories.</p></div><div class="refsect1"><a name="idm214174642192"></a><h2 id="System Packages">System Packages<a class="headerlink" title="Permalink to this headline" href="#System%20Packages">¶</a></h2><p>Developers of system packages should follow
|
||||
strict rules when placing their own files in the file
|
||||
system. The following table lists recommended
|
||||
locations for specific types of files supplied by the
|
||||
vendor.</p><div class="table"><a name="idm214173790208"></a><p class="title"><b>Table 1. System Package Vendor Files Locations</b></p><div class="table-contents"><table summary="System Package Vendor Files Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">/usr/bin</code></td><td align="left">Package executables that shall appear in the <code class="varname">$PATH</code> executable search path, compiled for any of the supported architectures compatible with the operating system. It is not recommended to place internal binaries or binaries that are not commonly invoked from the shell in this directory, such as daemon binaries. As this directory is shared with most other packages of the system special care should be taken to pick unique names for files placed here, that are unlikely to clash with other package's files.</td></tr><tr><td align="left"><code class="filename">/usr/lib/<em class="replaceable"><code>arch-id</code></em></code></td><td align="left">Public shared libraries of the package. As above, be careful with using too generic names, and pick unique names for your libraries to place here to avoid name clashes.</td></tr><tr><td align="left"><code class="filename">/usr/lib/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private, static vendor resources of the package, including private binaries and libraries, or any other kind of read-only vendor data.</td></tr><tr><td align="left"><code class="filename">/usr/lib/<em class="replaceable"><code>arch-id</code></em>/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private other vendor resources of the package that are architecture-specific and cannot be shared between architectures. Note that this generally does not include private executables since binaries of a specific architecture may be freely invoked from any other supported system architecture.</td></tr><tr><td align="left"><code class="filename">/usr/include/<em class="replaceable"><code>package</code></em></code></td><td align="left">Public C/C++ APIs of public shared libraries of the package.</td></tr></tbody></table></div></div><br class="table-break"><p>Additional static vendor files may be installed
|
||||
vendor.</p><div class="table"><a name="idm214174640880"></a><p class="title"><b>Table 1. System Package Vendor Files Locations</b></p><div class="table-contents"><table summary="System Package Vendor Files Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">/usr/bin</code></td><td align="left">Package executables that shall appear in the <code class="varname">$PATH</code> executable search path, compiled for any of the supported architectures compatible with the operating system. It is not recommended to place internal binaries or binaries that are not commonly invoked from the shell in this directory, such as daemon binaries. As this directory is shared with most other packages of the system special care should be taken to pick unique names for files placed here, that are unlikely to clash with other package's files.</td></tr><tr><td align="left"><code class="filename">/usr/lib/<em class="replaceable"><code>arch-id</code></em></code></td><td align="left">Public shared libraries of the package. As above, be careful with using too generic names, and pick unique names for your libraries to place here to avoid name clashes.</td></tr><tr><td align="left"><code class="filename">/usr/lib/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private, static vendor resources of the package, including private binaries and libraries, or any other kind of read-only vendor data.</td></tr><tr><td align="left"><code class="filename">/usr/lib/<em class="replaceable"><code>arch-id</code></em>/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private other vendor resources of the package that are architecture-specific and cannot be shared between architectures. Note that this generally does not include private executables since binaries of a specific architecture may be freely invoked from any other supported system architecture.</td></tr><tr><td align="left"><code class="filename">/usr/include/<em class="replaceable"><code>package</code></em></code></td><td align="left">Public C/C++ APIs of public shared libraries of the package.</td></tr></tbody></table></div></div><br class="table-break"><p>Additional static vendor files may be installed
|
||||
in the <code class="filename">/usr/share</code> hierarchy, to
|
||||
the locations defined by the various relevant
|
||||
specifications.</p><p>During runtime and for local configuration and
|
||||
state additional directories are defined:</p><div class="table"><a name="idm214173772160"></a><p class="title"><b>Table 2. System Package Variable Files Locations</b></p><div class="table-contents"><table summary="System Package Variable Files Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">/etc/<em class="replaceable"><code>package</code></em></code></td><td align="left">System-specific configuration for the package. It is recommended to default to safe fallbacks if this configuration is missing, if this is possible. Alternatively, a <a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a> fragment may be used to copy or symlink the necessary files and directories from <code class="filename">/usr/share/factory</code> during boot, via the "<code class="literal">L</code>" or "<code class="literal">C</code>" directives.</td></tr><tr><td align="left"><code class="filename">/run/<em class="replaceable"><code>package</code></em></code></td><td align="left">Runtime data for the package. Packages must be able to create the necessary subdirectories in this tree on their own, since the directory is flushed automatically on boot. Alternatively, a <a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a> fragment may be used to create the necessary directories during boot. Alternatively, the <code class="varname">RuntimeDirectory=</code> directive of service units may be used (see <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a> for details.)</td></tr><tr><td align="left"><code class="filename">/run/log/<em class="replaceable"><code>package</code></em></code></td><td align="left">Runtime log data for the package. As above, the package needs to make sure to create this directory if necessary, as it will be flushed on every boot.</td></tr><tr><td align="left"><code class="filename">/var/cache/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent cache data of the package. If this directory is flushed the application should work correctly on next invocation, though possibly slowed down due to the need to rebuild any local cache files. The application must be capable of recreating this directory should it be missing and necessary.</td></tr><tr><td align="left"><code class="filename">/var/lib/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent private data of the package. This is the primary place to put persistent data that does not fall into the other categories listed. Packages should be able to create the necessary subdirectories in this tree on their own, since the directory might be missing on boot. Alternatively, a <a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a> fragment may be used to create the necessary directories during boot.</td></tr><tr><td align="left"><code class="filename">/var/log/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent log data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</td></tr><tr><td align="left"><code class="filename">/var/spool/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent spool/queue data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</td></tr></tbody></table></div></div><br class="table-break"></div><div class="refsect1"><a name="idm214173746304"></a><h2 id="User Packages">User Packages<a class="headerlink" title="Permalink to this headline" href="#User%20Packages">¶</a></h2><p>Programs running in user context should follow
|
||||
state additional directories are defined:</p><div class="table"><a name="idm214174623088"></a><p class="title"><b>Table 2. System Package Variable Files Locations</b></p><div class="table-contents"><table summary="System Package Variable Files Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">/etc/<em class="replaceable"><code>package</code></em></code></td><td align="left">System-specific configuration for the package. It is recommended to default to safe fallbacks if this configuration is missing, if this is possible. Alternatively, a <a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a> fragment may be used to copy or symlink the necessary files and directories from <code class="filename">/usr/share/factory</code> during boot, via the "<code class="literal">L</code>" or "<code class="literal">C</code>" directives.</td></tr><tr><td align="left"><code class="filename">/run/<em class="replaceable"><code>package</code></em></code></td><td align="left">Runtime data for the package. Packages must be able to create the necessary subdirectories in this tree on their own, since the directory is flushed automatically on boot. Alternatively, a <a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a> fragment may be used to create the necessary directories during boot. Alternatively, the <code class="varname">RuntimeDirectory=</code> directive of service units may be used (see <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a> for details.)</td></tr><tr><td align="left"><code class="filename">/run/log/<em class="replaceable"><code>package</code></em></code></td><td align="left">Runtime log data for the package. As above, the package needs to make sure to create this directory if necessary, as it will be flushed on every boot.</td></tr><tr><td align="left"><code class="filename">/var/cache/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent cache data of the package. If this directory is flushed the application should work correctly on next invocation, though possibly slowed down due to the need to rebuild any local cache files. The application must be capable of recreating this directory should it be missing and necessary.</td></tr><tr><td align="left"><code class="filename">/var/lib/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent private data of the package. This is the primary place to put persistent data that does not fall into the other categories listed. Packages should be able to create the necessary subdirectories in this tree on their own, since the directory might be missing on boot. Alternatively, a <a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a> fragment may be used to create the necessary directories during boot.</td></tr><tr><td align="left"><code class="filename">/var/log/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent log data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</td></tr><tr><td align="left"><code class="filename">/var/spool/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent spool/queue data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</td></tr></tbody></table></div></div><br class="table-break"></div><div class="refsect1"><a name="idm214174598400"></a><h2 id="User Packages">User Packages<a class="headerlink" title="Permalink to this headline" href="#User%20Packages">¶</a></h2><p>Programs running in user context should follow
|
||||
strict rules when placing their own files in the
|
||||
user's home directory. The following table lists
|
||||
recommended locations in the home directory for
|
||||
@ -467,17 +470,17 @@
|
||||
application is installed in the home directory. (Note
|
||||
however, that user applications installed system-wide
|
||||
should follow the rules outlined above regarding
|
||||
placing vendor files.)</p><div class="table"><a name="idm214173744672"></a><p class="title"><b>Table 3. User Package Vendor File Locations</b></p><div class="table-contents"><table summary="User Package Vendor File Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">~/.local/bin</code></td><td align="left">Package executables that shall appear in the <code class="varname">$PATH</code> executable search path. It is not recommended to place internal executables or executables that are not commonly invoked from the shell in this directory, such as daemon executables. As this directory is shared with most other packages of the user special care should be taken to pick unique names for files placed here, that are unlikely to clash with other package's files.</td></tr><tr><td align="left"><code class="filename">~/.local/lib/<em class="replaceable"><code>arch-id</code></em></code></td><td align="left">Public shared libraries of the package. As above, be careful with using too generic names, and pick unique names for your libraries to place here to avoid name clashes.</td></tr><tr><td align="left"><code class="filename">~/.local/lib/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private, static vendor resources of the package, compatible wih any architecture, or any other kind of read-only vendor data.</td></tr><tr><td align="left"><code class="filename">~/.local/lib/<em class="replaceable"><code>arch-id</code></em>/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private other vendor resources of the package that are architecture-specific and cannot be shared between architectures.</td></tr></tbody></table></div></div><br class="table-break"><p>Additional static vendor files may be installed
|
||||
placing vendor files.)</p><div class="table"><a name="idm214174596800"></a><p class="title"><b>Table 3. User Package Vendor File Locations</b></p><div class="table-contents"><table summary="User Package Vendor File Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">~/.local/bin</code></td><td align="left">Package executables that shall appear in the <code class="varname">$PATH</code> executable search path. It is not recommended to place internal executables or executables that are not commonly invoked from the shell in this directory, such as daemon executables. As this directory is shared with most other packages of the user special care should be taken to pick unique names for files placed here, that are unlikely to clash with other package's files.</td></tr><tr><td align="left"><code class="filename">~/.local/lib/<em class="replaceable"><code>arch-id</code></em></code></td><td align="left">Public shared libraries of the package. As above, be careful with using too generic names, and pick unique names for your libraries to place here to avoid name clashes.</td></tr><tr><td align="left"><code class="filename">~/.local/lib/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private, static vendor resources of the package, compatible with any architecture, or any other kind of read-only vendor data.</td></tr><tr><td align="left"><code class="filename">~/.local/lib/<em class="replaceable"><code>arch-id</code></em>/<em class="replaceable"><code>package</code></em></code></td><td align="left">Private other vendor resources of the package that are architecture-specific and cannot be shared between architectures.</td></tr></tbody></table></div></div><br class="table-break"><p>Additional static vendor files may be installed
|
||||
in the <code class="filename">~/.local/share</code> hierarchy,
|
||||
to the locations defined by the various relevant
|
||||
specifications.</p><p>During runtime and for local configuration and
|
||||
state additional directories are defined:</p><div class="table"><a name="idm214173728816"></a><p class="title"><b>Table 4. User Package Variable File Locations</b></p><div class="table-contents"><table summary="User Package Variable File Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">~/.config/<em class="replaceable"><code>package</code></em></code></td><td align="left">User-specific configuration and state for the package. It is required to default to safe fallbacks if this configuration is missing.</td></tr><tr><td align="left"><code class="filename"><code class="varname">$XDG_RUNTIME_DIR</code>/<em class="replaceable"><code>package</code></em></code></td><td align="left">User runtime data for the package.</td></tr><tr><td align="left"><code class="filename">~/.cache/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent cache data of the package. If this directory is flushed the application should work correctly on next invocation, though possibly slowed down due to the need to rebuild any local cache files. The application must be capable of recreating this directory should it be missing and necessary.</td></tr></tbody></table></div></div><br class="table-break"></div><div class="refsect1"><a name="idm214173717072"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
state additional directories are defined:</p><div class="table"><a name="idm214174581184"></a><p class="title"><b>Table 4. User Package Variable File Locations</b></p><div class="table-contents"><table summary="User Package Variable File Locations" border="1"><colgroup><col align="left" class="directory"><col align="left" class="purpose"></colgroup><thead><tr><th align="left">Directory</th><th align="left">Purpose</th></tr></thead><tbody><tr><td align="left"><code class="filename">~/.config/<em class="replaceable"><code>package</code></em></code></td><td align="left">User-specific configuration and state for the package. It is required to default to safe fallbacks if this configuration is missing.</td></tr><tr><td align="left"><code class="filename"><code class="varname">$XDG_RUNTIME_DIR</code>/<em class="replaceable"><code>package</code></em></code></td><td align="left">User runtime data for the package.</td></tr><tr><td align="left"><code class="filename">~/.cache/<em class="replaceable"><code>package</code></em></code></td><td align="left">Persistent cache data of the package. If this directory is flushed the application should work correctly on next invocation, though possibly slowed down due to the need to rebuild any local cache files. The application must be capable of recreating this directory should it be missing and necessary.</td></tr></tbody></table></div></div><br class="table-break"></div><div class="refsect1"><a name="idm214174569984"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="hier.html"><span class="citerefentry"><span class="refentrytitle">hier</span>(7)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man7/hier.7.html"><span class="citerefentry"><span class="refentrytitle">hier</span>(7)</span></a>,
|
||||
<a href="systemd-path.html"><span class="citerefentry"><span class="refentrytitle">systemd-path</span>(1)</span></a>,
|
||||
<a href="systemd-efi-boot-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-efi-boot-generator</span>(8)</span></a>,
|
||||
<a href="sysctl.d.html"><span class="citerefentry"><span class="refentrytitle">sysctl.d</span>(5)</span></a>,
|
||||
<a href="tmpfiles.d.html"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -57,7 +57,7 @@
|
||||
specifically the hierarchy described in the <ulink
|
||||
url="http://refspecs.linuxfoundation.org/FHS_2.3/fhs-2.3.html">File
|
||||
System Hierarchy</ulink> specification and
|
||||
<citerefentry><refentrytitle>hier</refentrytitle><manvolnum>7</manvolnum></citerefentry>. This
|
||||
<citerefentry project='man-pages'><refentrytitle>hier</refentrytitle><manvolnum>7</manvolnum></citerefentry>. This
|
||||
manual page describes a more minimal, modernized
|
||||
subset of these specifications that defines more
|
||||
strictly the suggestions and restrictions systemd
|
||||
@ -178,8 +178,8 @@
|
||||
accessible to other users of the
|
||||
system it is essential that this
|
||||
directory is only written to with the
|
||||
<citerefentry><refentrytitle>mkstemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>mkdtemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
<citerefentry project='man-pages'><refentrytitle>mkstemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>mkdtemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
and related calls. This directory is
|
||||
usually flushed at boot-up. Also,
|
||||
files that are not accessed within a
|
||||
@ -190,7 +190,9 @@
|
||||
should prefer using the directory
|
||||
specified in it over directly
|
||||
referencing
|
||||
<filename>/tmp</filename> (see <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry> for details).</para></listitem>
|
||||
<filename>/tmp</filename> (see <citerefentry project='man-pages'><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>
|
||||
and
|
||||
<ulink url="http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap08.html#tag_08_03">IEEE Std 1003.1</ulink> for details).</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
</variablelist>
|
||||
@ -422,7 +424,7 @@
|
||||
private logs in this directory, though
|
||||
it is recommended to do most logging
|
||||
via the
|
||||
<citerefentry><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
<citerefentry project='man-pages'><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
and
|
||||
<citerefentry><refentrytitle>sd_journal_print</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
calls.</para></listitem>
|
||||
@ -452,8 +454,8 @@
|
||||
restrictions as with
|
||||
<filename>/tmp</filename> apply, and
|
||||
hence only
|
||||
<citerefentry><refentrytitle>mkstemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>mkdtemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
<citerefentry project='man-pages'><refentrytitle>mkstemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>mkdtemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
||||
or similar calls should be used to
|
||||
make use of this directory. If
|
||||
applications find the environment
|
||||
@ -461,7 +463,8 @@
|
||||
set they should prefer using the
|
||||
directory specified in it over
|
||||
directly referencing
|
||||
<filename>/var/tmp</filename> (see <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry> for details).
|
||||
<filename>/var/tmp</filename> (see <citerefentry project='man-pages'><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>
|
||||
for details).
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
@ -524,7 +527,7 @@
|
||||
is mostly an API to interface with the
|
||||
kernel and not a place where normal
|
||||
files may be stored. For details, see
|
||||
<citerefentry><refentrytitle>proc</refentrytitle><manvolnum>5</manvolnum></citerefentry>. A
|
||||
<citerefentry project='man-pages'><refentrytitle>proc</refentrytitle><manvolnum>5</manvolnum></citerefentry>. A
|
||||
number of special purpose virtual file
|
||||
systems might be mounted below this
|
||||
directory.</para></listitem>
|
||||
@ -911,7 +914,7 @@
|
||||
</row>
|
||||
<row>
|
||||
<entry><filename>~/.local/lib/<replaceable>package</replaceable></filename></entry>
|
||||
<entry>Private, static vendor resources of the package, compatible wih any architecture, or any other kind of read-only vendor data.</entry>
|
||||
<entry>Private, static vendor resources of the package, compatible with any architecture, or any other kind of read-only vendor data.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><filename>~/.local/lib/<replaceable>arch-id</replaceable>/<replaceable>package</replaceable></filename></entry>
|
||||
@ -962,12 +965,12 @@
|
||||
<title>See Also</title>
|
||||
<para>
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>hier</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>hier</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-path</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-efi-boot-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>sysctl.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry project='die-net'><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
70
man/glib-event-glue.c
Normal file
70
man/glib-event-glue.c
Normal file
@ -0,0 +1,70 @@
|
||||
/***
|
||||
Copyright 2014 Tom Gundersen
|
||||
|
||||
Permission is hereby granted, free of charge, to any person
|
||||
obtaining a copy of this software and associated documentation files
|
||||
(the "Software"), to deal in the Software without restriction,
|
||||
including without limitation the rights to use, copy, modify, merge,
|
||||
publish, distribute, sublicense, and/or sell copies of the Software,
|
||||
and to permit persons to whom the Software is furnished to do so,
|
||||
subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be
|
||||
included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
||||
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
||||
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
||||
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
***/
|
||||
|
||||
#include <assert.h>
|
||||
#include <errno.h>
|
||||
#include <stdlib.h>
|
||||
|
||||
typedef struct SDEventSource {
|
||||
GSource source;
|
||||
GPollFD pollfd;
|
||||
sd_event *event;
|
||||
} SDEventSource;
|
||||
|
||||
static gboolean event_prepare(GSource *source, gint *timeout_) {
|
||||
return sd_event_prepare(((SDEventSource *)source)->event) > 0;
|
||||
}
|
||||
|
||||
static gboolean event_check(GSource *source) {
|
||||
return sd_event_wait(((SDEventSource *)source)->event, 0) > 0;
|
||||
}
|
||||
|
||||
static gboolean event_dispatch(GSource *source, GSourceFunc callback, gpointer user_data) {
|
||||
return sd_event_dispatch(((SDEventSource *)source)->event) > 0;
|
||||
}
|
||||
|
||||
static void event_finalize(GSource *source) {
|
||||
sd_event_unref(((SDEventSource *)source)->event);
|
||||
}
|
||||
|
||||
static GSourceFuncs event_funcs = {
|
||||
.prepare = event_prepare,
|
||||
.check = event_check,
|
||||
.dispatch = event_dispatch,
|
||||
.finalize = event_finalize,
|
||||
};
|
||||
|
||||
GSource *g_sd_event_create_source(sd_event *event) {
|
||||
SDEventSource *source;
|
||||
|
||||
source = (SDEventSource *)g_source_new(&event_funcs, sizeof(SDEventSource));
|
||||
|
||||
source->event = sd_event_ref(event);
|
||||
source->pollfd.fd = sd_event_get_fd(event);
|
||||
source->pollfd.events = G_IO_IN | G_IO_HUP | G_IO_ERR;
|
||||
|
||||
g_source_add_poll((GSource *)source, &source->pollfd);
|
||||
|
||||
return (GSource *)source;
|
||||
}
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "HALT" "8" "" "systemd 215" "halt"
|
||||
.TH "HALT" "8" "" "systemd 217" "halt"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
@ -19,10 +19,10 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="halt"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>halt, poweroff, reboot — Halt, power-off or reboot the machine</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">halt [OPTIONS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">poweroff [OPTIONS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">reboot [OPTIONS...]</code> </p></div></div><div class="refsect1"><a name="idm214185642768"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>halt</strong></span>,
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="halt"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>halt, poweroff, reboot — Halt, power-off or reboot the machine</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">halt [OPTIONS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">poweroff [OPTIONS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">reboot [OPTIONS...]</code> </p></div></div><div class="refsect1"><a name="idm214184881712"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>halt</strong></span>,
|
||||
<span class="command"><strong>poweroff</strong></span>, <span class="command"><strong>reboot</strong></span>
|
||||
may be used to halt, power-off or reboot the
|
||||
machine.</p></div><div class="refsect1"><a name="idm214186089440"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--help"><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#--help">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
machine.</p></div><div class="refsect1"><a name="idm214184878512"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--help"><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#--help">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--halt"><span class="term"><code class="option">--halt</code></span><a class="headerlink" title="Permalink to this term" href="#--halt">¶</a></dt><dd><p>Halt the machine,
|
||||
regardless of which one of the three
|
||||
commands is invoked.</p></dd><dt id="-p"><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--poweroff</code></span><a class="headerlink" title="Permalink to this term" href="#-p">¶</a></dt><dd><p>Power-off the machine,
|
||||
@ -36,11 +36,11 @@
|
||||
power-off, reboot.</p></dd><dt id="-d"><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--no-wtmp</code></span><a class="headerlink" title="Permalink to this term" href="#-d">¶</a></dt><dd><p>Do not write wtmp
|
||||
shutdown entry.</p></dd><dt id="--no-wall"><span class="term"><code class="option">--no-wall</code></span><a class="headerlink" title="Permalink to this term" href="#--no-wall">¶</a></dt><dd><p>Do not send wall
|
||||
message before
|
||||
halt, power-off, reboot.</p></dd></dl></div></div><div class="refsect1"><a name="idm214183375264"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
||||
code otherwise.</p></div><div class="refsect1"><a name="idm214184284480"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>These are legacy commands available for
|
||||
compatibility only.</p></div><div class="refsect1"><a name="idm214184877296"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
halt, power-off, reboot.</p></dd></dl></div></div><div class="refsect1"><a name="idm214188761648"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
||||
code otherwise.</p></div><div class="refsect1"><a name="idm214188760464"></a><h2 id="Notes">Notes<a class="headerlink" title="Permalink to this headline" href="#Notes">¶</a></h2><p>These are legacy commands available for
|
||||
compatibility only.</p></div><div class="refsect1"><a name="idm214188759280"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
|
||||
<a href="shutdown.html"><span class="citerefentry"><span class="refentrytitle">shutdown</span>(8)</span></a>,
|
||||
<a href="wall.html"><span class="citerefentry"><span class="refentrytitle">wall</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man1/wall.1.html"><span class="citerefentry"><span class="refentrytitle">wall</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -165,7 +165,7 @@
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>shutdown</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
<citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "HOSTNAME" "5" "" "systemd 215" "hostname"
|
||||
.TH "HOSTNAME" "5" "" "systemd 217" "hostname"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -36,7 +36,9 @@ Depending on the operating system, other configuration files might be checked fo
|
||||
.PP
|
||||
You may use
|
||||
\fBhostnamectl\fR(1)
|
||||
to change the value of this file from the command line\&.
|
||||
to change the value of this file during runtime from the command line\&. Use
|
||||
\fBsystemd-firstboot\fR(1)
|
||||
to initialize it on mounted (but not booted) system images\&.
|
||||
.SH "HISTORY"
|
||||
.PP
|
||||
The simple configuration file format of
|
||||
@ -51,4 +53,5 @@ originates from Debian GNU/Linux\&.
|
||||
\fBmachine-id\fR(5),
|
||||
\fBmachine-info\fR(5),
|
||||
\fBhostnamectl\fR(1),
|
||||
\fBsystemd-hostnamed.service\fR(8)
|
||||
\fBsystemd-hostnamed.service\fR(8),
|
||||
\fBsystemd-firstboot\fR(1)
|
||||
|
||||
@ -19,10 +19,10 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="hostname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>hostname — Local hostname configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/hostname</code></p></div><div class="refsect1"><a name="idm214180092048"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>The <code class="filename">/etc/hostname</code> file
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="hostname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>hostname — Local hostname configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/hostname</code></p></div><div class="refsect1"><a name="idm214192231936"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>The <code class="filename">/etc/hostname</code> file
|
||||
configures the name of the local system that is set
|
||||
during boot using the
|
||||
<a href="sethostname.html"><span class="citerefentry"><span class="refentrytitle">sethostname</span>(2)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man2/sethostname.2.html"><span class="citerefentry"><span class="refentrytitle">sethostname</span>(2)</span></a>
|
||||
system call. It should contain a single
|
||||
newline-terminated hostname string. The
|
||||
hostname may be a free-form string up to 64 characters
|
||||
@ -34,16 +34,20 @@
|
||||
configuration files might be checked for configuration
|
||||
of the hostname as well, however only as fallback.</p><p>You may use
|
||||
<a href="hostnamectl.html"><span class="citerefentry"><span class="refentrytitle">hostnamectl</span>(1)</span></a>
|
||||
to change the value of this file from the command
|
||||
line.</p></div><div class="refsect1"><a name="idm214181007760"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p>The simple configuration file format of
|
||||
to change the value of this file during runtime from
|
||||
the command line. Use
|
||||
<a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
|
||||
to initialize it on mounted (but not booted) system
|
||||
images.</p></div><div class="refsect1"><a name="idm214192225728"></a><h2 id="History">History<a class="headerlink" title="Permalink to this headline" href="#History">¶</a></h2><p>The simple configuration file format of
|
||||
<code class="filename">/etc/hostname</code> originates from
|
||||
Debian GNU/Linux.</p></div><div class="refsect1"><a name="idm214180591920"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
Debian GNU/Linux.</p></div><div class="refsect1"><a name="idm214192223856"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="sethostname.html"><span class="citerefentry"><span class="refentrytitle">sethostname</span>(2)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man2/sethostname.2.html"><span class="citerefentry"><span class="refentrytitle">sethostname</span>(2)</span></a>,
|
||||
<a href="hostname.html"><span class="citerefentry"><span class="refentrytitle">hostname</span>(1)</span></a>,
|
||||
<a href="hostname.html"><span class="citerefentry"><span class="refentrytitle">hostname</span>(7)</span></a>,
|
||||
<a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>,
|
||||
<a href="machine-info.html"><span class="citerefentry"><span class="refentrytitle">machine-info</span>(5)</span></a>,
|
||||
<a href="hostnamectl.html"><span class="citerefentry"><span class="refentrytitle">hostnamectl</span>(1)</span></a>,
|
||||
<a href="systemd-hostnamed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-hostnamed.service</span>(8)</span></a>
|
||||
<a href="systemd-hostnamed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-hostnamed.service</span>(8)</span></a>,
|
||||
<a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -73,8 +73,11 @@
|
||||
|
||||
<para>You may use
|
||||
<citerefentry><refentrytitle>hostnamectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
to change the value of this file from the command
|
||||
line.</para>
|
||||
to change the value of this file during runtime from
|
||||
the command line. Use
|
||||
<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
to initialize it on mounted (but not booted) system
|
||||
images.</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
@ -95,7 +98,8 @@
|
||||
<citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>hostnamectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-hostnamed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<citerefentry><refentrytitle>systemd-hostnamed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "HOSTNAMECTL" "1" "" "systemd 215" "hostnamectl"
|
||||
.TH "HOSTNAMECTL" "1" "" "systemd 217" "hostnamectl"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -38,7 +38,11 @@ The static hostname is stored in
|
||||
\fBhostname\fR(5)
|
||||
for more information\&. The pretty hostname, chassis type, and icon name are stored in
|
||||
/etc/machine\-info, see
|
||||
\fBmachine-id\fR(5)\&.
|
||||
\fBmachine-info\fR(5)\&.
|
||||
.PP
|
||||
Use
|
||||
\fBsystemd-firstboot\fR(1)
|
||||
to initialize the system host name for mounted (but not booted) system images\&.
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
The following options are understood:
|
||||
@ -48,11 +52,6 @@ The following options are understood:
|
||||
Do not query the user for authentication for privileged operations\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-P\fR, \fB\-\-privileged\fR
|
||||
.RS 4
|
||||
Acquire privileges via PolicyKit before executing the operation\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-static\fR, \fB\-\-transient\fR, \fB\-\-pretty\fR
|
||||
.RS 4
|
||||
If
|
||||
@ -90,38 +89,73 @@ The following commands are understood:
|
||||
Show current system hostname and related information\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBset\-hostname [NAME]\fR
|
||||
\fBset\-hostname \fR\fB\fINAME\fR\fR
|
||||
.RS 4
|
||||
Set the system hostname\&. By default, this will alter the pretty, the static, and the transient hostname alike; however, if one or more of
|
||||
Set the system hostname to
|
||||
\fINAME\fR\&. By default, this will alter the pretty, the static, and the transient hostname alike; however, if one or more of
|
||||
\fB\-\-static\fR,
|
||||
\fB\-\-transient\fR,
|
||||
\fB\-\-pretty\fR
|
||||
are used, only the selected hostnames are changed\&. If the pretty hostname is being set, and static or transient are being set as well, the specified hostname will be simplified in regards to the character set used before the latter are updated\&. This is done by replacing spaces with
|
||||
"\-"
|
||||
and removing special characters\&. This ensures that the pretty and the static hostname are always closely related while still following the validity rules of the specific name\&. This simplification of the hostname string is not done if only the transient and/or static host names are set, and the pretty host name is left untouched\&. Pass the empty string
|
||||
and removing special characters\&. This ensures that the pretty and the static hostname are always closely related while still following the validity rules of the specific name\&. This simplification of the hostname string is not done if only the transient and/or static host names are set, and the pretty host name is left untouched\&.
|
||||
.sp
|
||||
Pass the empty string
|
||||
""
|
||||
as the hostname to reset the selected hostnames to their default (usually
|
||||
"localhost")\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBset\-icon\-name [NAME]\fR
|
||||
\fBset\-icon\-name \fR\fB\fINAME\fR\fR
|
||||
.RS 4
|
||||
Set the system icon name\&. The icon name is used by some graphical applications to visualize this host\&. The icon name should follow the
|
||||
\m[blue]\fBIcon Naming Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. Pass an empty string to this operation to reset the icon name to the default value, which is determined from chassis type (see below) and possibly other parameters\&.
|
||||
Set the system icon name to
|
||||
\fINAME\fR\&. The icon name is used by some graphical applications to visualize this host\&. The icon name should follow the
|
||||
\m[blue]\fBIcon Naming Specification\fR\m[]\&\s-2\u[1]\d\s+2\&.
|
||||
.sp
|
||||
Pass an empty string to reset the icon name to the default value, which is determined from chassis type (see below) and possibly other parameters\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBset\-chassis [TYPE]\fR
|
||||
\fBset\-chassis \fR\fB\fITYPE\fR\fR
|
||||
.RS 4
|
||||
Set the chassis type\&. The chassis type is used by some graphical applications to visualize the host or alter user interaction\&. Currently, the following chassis types are defined:
|
||||
Set the chassis type to
|
||||
\fITYPE\fR\&. The chassis type is used by some graphical applications to visualize the host or alter user interaction\&. Currently, the following chassis types are defined:
|
||||
"desktop",
|
||||
"laptop",
|
||||
"server",
|
||||
"tablet",
|
||||
"handset", as well as the special chassis types
|
||||
"handset",
|
||||
"watch", as well as the special chassis types
|
||||
"vm"
|
||||
and
|
||||
"container"
|
||||
for virtualized systems that lack an immediate physical chassis\&. Pass an empty string to this operation to reset the chassis type to the default value which is determined from the firmware and possibly other parameters\&.
|
||||
for virtualized systems that lack an immediate physical chassis\&.
|
||||
.sp
|
||||
Pass an empty string to reset the chassis type to the default value which is determined from the firmware and possibly other parameters\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBset\-deployment \fR\fB\fIENVIRONMENT\fR\fR
|
||||
.RS 4
|
||||
Set the deployment environment description\&.
|
||||
\fIENVIRONMENT\fR
|
||||
must be a single word without any control characters\&. One of the following is suggested:
|
||||
"development",
|
||||
"integration",
|
||||
"staging",
|
||||
"production"\&.
|
||||
.sp
|
||||
Pass an empty string to reset to the default empty value\&.
|
||||
.RE
|
||||
.PP
|
||||
\fBset\-location \fR\fB\fILOCATION\fR\fR
|
||||
.RS 4
|
||||
Set the location string for the system, if it is known\&.
|
||||
\fILOCATION\fR
|
||||
should be a human\-friendly, free\-form string describing the physical location of the system, if it is known and applicable\&. This may be as generic as
|
||||
"Berlin, Germany"
|
||||
or as specific as
|
||||
"Left Rack, 2nd Shelf"\&.
|
||||
.sp
|
||||
Pass an empty string to reset to the default empty value\&.
|
||||
.RE
|
||||
.SH "EXIT STATUS"
|
||||
.PP
|
||||
@ -133,7 +167,8 @@ On success, 0 is returned, a non\-zero failure code otherwise\&.
|
||||
\fBhostname\fR(5),
|
||||
\fBmachine-info\fR(5),
|
||||
\fBsystemctl\fR(1),
|
||||
\fBsystemd-hostnamed.service\fR(8)
|
||||
\fBsystemd-hostnamed.service\fR(8),
|
||||
\fBsystemd-firstboot\fR(1)
|
||||
.SH "NOTES"
|
||||
.IP " 1." 4
|
||||
Icon Naming Specification
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="hostnamectl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>hostnamectl — Control the system hostname</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">hostnamectl</code> [OPTIONS...] {COMMAND}</p></div></div><div class="refsect1"><a name="idm214197136464"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>hostnamectl</strong></span> may be used to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="hostnamectl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>hostnamectl — Control the system hostname</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">hostnamectl</code> [OPTIONS...] {COMMAND}</p></div></div><div class="refsect1"><a name="idm214198261376"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>hostnamectl</strong></span> may be used to
|
||||
query and change the system hostname and related
|
||||
settings.</p><p>This tool distinguishes three different
|
||||
hostnames: the high-level "pretty" hostname which
|
||||
@ -38,10 +38,12 @@
|
||||
for more information. The pretty hostname, chassis
|
||||
type, and icon name are stored in
|
||||
<code class="filename">/etc/machine-info</code>, see
|
||||
<a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>.</p></div><div class="refsect1"><a name="idm214193390992"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-ask-password"><span class="term"><code class="option">--no-ask-password</code></span><a class="headerlink" title="Permalink to this term" href="#--no-ask-password">¶</a></dt><dd><p>Do not query the user
|
||||
<a href="machine-info.html"><span class="citerefentry"><span class="refentrytitle">machine-info</span>(5)</span></a>.</p><p>Use
|
||||
<a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
|
||||
to initialize the system host name for mounted (but
|
||||
not booted) system images.</p></div><div class="refsect1"><a name="idm214198252960"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-ask-password"><span class="term"><code class="option">--no-ask-password</code></span><a class="headerlink" title="Permalink to this term" href="#--no-ask-password">¶</a></dt><dd><p>Do not query the user
|
||||
for authentication for privileged
|
||||
operations.</p></dd><dt id="-P"><span class="term"><code class="option">-P</code>, </span><span class="term"><code class="option">--privileged</code></span><a class="headerlink" title="Permalink to this term" href="#-P">¶</a></dt><dd><p>Acquire privileges via PolicyKit
|
||||
before executing the operation.</p></dd><dt id="--static"><span class="term"><code class="option">--static</code>, </span><span class="term"><code class="option">--transient</code>, </span><span class="term"><code class="option">--pretty</code></span><a class="headerlink" title="Permalink to this term" href="#--static">¶</a></dt><dd><p>If
|
||||
operations.</p></dd><dt id="--static"><span class="term"><code class="option">--static</code>, </span><span class="term"><code class="option">--transient</code>, </span><span class="term"><code class="option">--pretty</code></span><a class="headerlink" title="Permalink to this term" href="#--static">¶</a></dt><dd><p>If
|
||||
<span class="command"><strong>status</strong></span> is used (or
|
||||
no explicit command is given) and one
|
||||
of those fields is given,
|
||||
@ -64,11 +66,12 @@
|
||||
<em class="replaceable"><code>HOST</code></em></strong></span>.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd></dl></div><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="status"><span class="term"><span class="command"><strong>status</strong></span></span><a class="headerlink" title="Permalink to this term" href="#status">¶</a></dt><dd><p>Show current system
|
||||
hostname and related
|
||||
information.</p></dd><dt id="set-hostname [NAME]"><span class="term"><span class="command"><strong>set-hostname [NAME]</strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-hostname%20%5BNAME%5D">¶</a></dt><dd><p>Set the system
|
||||
hostname. By default, this will alter
|
||||
the pretty, the static, and the
|
||||
transient hostname alike; however, if
|
||||
one or more of
|
||||
information.</p></dd><dt id="set-hostname NAME"><span class="term"><span class="command"><strong>set-hostname <em class="replaceable"><code>NAME</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-hostname%20NAME">¶</a></dt><dd><p>Set the system
|
||||
hostname to
|
||||
<em class="replaceable"><code>NAME</code></em>. By
|
||||
default, this will alter the pretty,
|
||||
the static, and the transient hostname
|
||||
alike; however, if one or more of
|
||||
<code class="option">--static</code>,
|
||||
<code class="option">--transient</code>,
|
||||
<code class="option">--pretty</code> are used,
|
||||
@ -89,46 +92,68 @@
|
||||
the hostname string is not done if
|
||||
only the transient and/or static host
|
||||
names are set, and the pretty host
|
||||
name is left untouched. Pass the empty
|
||||
string "<code class="literal"></code>" as the
|
||||
hostname to reset the selected
|
||||
hostnames to their default (usually
|
||||
"<code class="literal">localhost</code>").</p></dd><dt id="set-icon-name [NAME]"><span class="term"><span class="command"><strong>set-icon-name [NAME]</strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-icon-name%20%5BNAME%5D">¶</a></dt><dd><p>Set the system icon
|
||||
name. The icon name is used by some
|
||||
name is left untouched.</p><p>Pass the empty string
|
||||
"<code class="literal"></code>" as the hostname to
|
||||
reset the selected hostnames to their
|
||||
default (usually
|
||||
"<code class="literal">localhost</code>").</p></dd><dt id="set-icon-name NAME"><span class="term"><span class="command"><strong>set-icon-name <em class="replaceable"><code>NAME</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-icon-name%20NAME">¶</a></dt><dd><p>Set the system icon
|
||||
name to
|
||||
<em class="replaceable"><code>NAME</code></em>. The
|
||||
icon name is used by some graphical
|
||||
applications to visualize this host.
|
||||
The icon name should follow the <a class="ulink" href="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html" target="_top">Icon
|
||||
Naming Specification</a>.</p><p>Pass an empty string to reset
|
||||
the icon name to the default value,
|
||||
which is determined from chassis type
|
||||
(see below) and possibly other
|
||||
parameters.</p></dd><dt id="set-chassis TYPE"><span class="term"><span class="command"><strong>set-chassis <em class="replaceable"><code>TYPE</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-chassis%20TYPE">¶</a></dt><dd><p>Set the chassis type
|
||||
to <em class="replaceable"><code>TYPE</code></em>.
|
||||
The chassis type is used by some
|
||||
graphical applications to visualize
|
||||
this host. The icon name should follow
|
||||
the <a class="ulink" href="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html" target="_top">Icon
|
||||
Naming Specification</a>. Pass an
|
||||
empty string to this operation to
|
||||
reset the icon name to the default
|
||||
value, which is determined from chassis
|
||||
type (see below) and possibly other
|
||||
parameters.</p></dd><dt id="set-chassis [TYPE]"><span class="term"><span class="command"><strong>set-chassis [TYPE]</strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-chassis%20%5BTYPE%5D">¶</a></dt><dd><p>Set the chassis
|
||||
type. The chassis type is used by some
|
||||
graphical applications to visualize
|
||||
the host or alter user
|
||||
interaction. Currently, the following
|
||||
chassis types are defined:
|
||||
the host or alter user interaction.
|
||||
Currently, the following chassis types
|
||||
are defined:
|
||||
"<code class="literal">desktop</code>",
|
||||
"<code class="literal">laptop</code>",
|
||||
"<code class="literal">server</code>",
|
||||
"<code class="literal">tablet</code>",
|
||||
"<code class="literal">handset</code>", as well as
|
||||
"<code class="literal">handset</code>",
|
||||
"<code class="literal">watch</code>", as well as
|
||||
the special chassis types
|
||||
"<code class="literal">vm</code>" and
|
||||
"<code class="literal">container</code>" for
|
||||
virtualized systems that lack an
|
||||
immediate physical chassis. Pass an
|
||||
empty string to this operation to
|
||||
reset the chassis type to the default
|
||||
value which is determined from the
|
||||
firmware and possibly other
|
||||
parameters.</p></dd></dl></div></div><div class="refsect1"><a name="idm214197252416"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
||||
code otherwise.</p></div><div class="refsect1"><a name="idm214197251232"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
immediate physical chassis.</p><p>Pass an empty string to reset
|
||||
the chassis type to the default value
|
||||
which is determined from the firmware
|
||||
and possibly other parameters.</p></dd><dt id="set-deployment ENVIRONMENT"><span class="term"><span class="command"><strong>set-deployment <em class="replaceable"><code>ENVIRONMENT</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-deployment%20ENVIRONMENT">¶</a></dt><dd><p>Set the deployment
|
||||
environment
|
||||
description. <em class="replaceable"><code>ENVIRONMENT</code></em>
|
||||
must be a single word without any
|
||||
control characters. One of the
|
||||
following is suggested:
|
||||
"<code class="literal">development</code>",
|
||||
"<code class="literal">integration</code>",
|
||||
"<code class="literal">staging</code>",
|
||||
"<code class="literal">production</code>".
|
||||
</p><p>Pass an empty string to reset to
|
||||
the default empty value.</p></dd><dt id="set-location LOCATION"><span class="term"><span class="command"><strong>set-location <em class="replaceable"><code>LOCATION</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#set-location%20LOCATION">¶</a></dt><dd><p>Set the location
|
||||
string for the system, if it is
|
||||
known. <em class="replaceable"><code>LOCATION</code></em>
|
||||
should be a human-friendly, free-form
|
||||
string describing the physical
|
||||
location of the system, if it is known
|
||||
and applicable. This may be as generic
|
||||
as "<code class="literal">Berlin, Germany</code>"
|
||||
or as specific as "<code class="literal">Left Rack,
|
||||
2nd Shelf</code>".</p><p>Pass an empty string to reset to
|
||||
the default empty value.</p></dd></dl></div></div><div class="refsect1"><a name="idm214197185104"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
||||
code otherwise.</p></div><div class="refsect1"><a name="idm214197183952"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="hostname.html"><span class="citerefentry"><span class="refentrytitle">hostname</span>(1)</span></a>,
|
||||
<a href="hostname.html"><span class="citerefentry"><span class="refentrytitle">hostname</span>(5)</span></a>,
|
||||
<a href="machine-info.html"><span class="citerefentry"><span class="refentrytitle">machine-info</span>(5)</span></a>,
|
||||
<a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
|
||||
<a href="systemd-hostnamed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-hostnamed.service</span>(8)</span></a>
|
||||
<a href="systemd-hostnamed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-hostnamed.service</span>(8)</span></a>,
|
||||
<a href="systemd-firstboot.html"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -84,7 +84,12 @@
|
||||
for more information. The pretty hostname, chassis
|
||||
type, and icon name are stored in
|
||||
<filename>/etc/machine-info</filename>, see
|
||||
<citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
|
||||
<citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
|
||||
|
||||
<para>Use
|
||||
<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
to initialize the system host name for mounted (but
|
||||
not booted) system images.</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
@ -101,14 +106,6 @@
|
||||
operations.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>-P</option></term>
|
||||
<term><option>--privileged</option></term>
|
||||
|
||||
<listitem><para>Acquire privileges via PolicyKit
|
||||
before executing the operation.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>--static</option></term>
|
||||
<term><option>--transient</option></term>
|
||||
@ -149,13 +146,14 @@
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>set-hostname [NAME]</command></term>
|
||||
<term><command>set-hostname <replaceable>NAME</replaceable></command></term>
|
||||
|
||||
<listitem><para>Set the system
|
||||
hostname. By default, this will alter
|
||||
the pretty, the static, and the
|
||||
transient hostname alike; however, if
|
||||
one or more of
|
||||
hostname to
|
||||
<replaceable>NAME</replaceable>. By
|
||||
default, this will alter the pretty,
|
||||
the static, and the transient hostname
|
||||
alike; however, if one or more of
|
||||
<option>--static</option>,
|
||||
<option>--transient</option>,
|
||||
<option>--pretty</option> are used,
|
||||
@ -176,56 +174,101 @@
|
||||
the hostname string is not done if
|
||||
only the transient and/or static host
|
||||
names are set, and the pretty host
|
||||
name is left untouched. Pass the empty
|
||||
string <literal></literal> as the
|
||||
hostname to reset the selected
|
||||
hostnames to their default (usually
|
||||
name is left untouched.</para>
|
||||
|
||||
<para>Pass the empty string
|
||||
<literal></literal> as the hostname to
|
||||
reset the selected hostnames to their
|
||||
default (usually
|
||||
<literal>localhost</literal>).</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>set-icon-name [NAME]</command></term>
|
||||
<term><command>set-icon-name <replaceable>NAME</replaceable></command></term>
|
||||
|
||||
<listitem><para>Set the system icon
|
||||
name. The icon name is used by some
|
||||
graphical applications to visualize
|
||||
this host. The icon name should follow
|
||||
the <ulink
|
||||
name to
|
||||
<replaceable>NAME</replaceable>. The
|
||||
icon name is used by some graphical
|
||||
applications to visualize this host.
|
||||
The icon name should follow the <ulink
|
||||
url="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">Icon
|
||||
Naming Specification</ulink>. Pass an
|
||||
empty string to this operation to
|
||||
reset the icon name to the default
|
||||
value, which is determined from chassis
|
||||
type (see below) and possibly other
|
||||
Naming Specification</ulink>.</para>
|
||||
|
||||
<para>Pass an empty string to reset
|
||||
the icon name to the default value,
|
||||
which is determined from chassis type
|
||||
(see below) and possibly other
|
||||
parameters.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>set-chassis [TYPE]</command></term>
|
||||
<term><command>set-chassis <replaceable>TYPE</replaceable></command></term>
|
||||
|
||||
<listitem><para>Set the chassis
|
||||
type. The chassis type is used by some
|
||||
<listitem><para>Set the chassis type
|
||||
to <replaceable>TYPE</replaceable>.
|
||||
The chassis type is used by some
|
||||
graphical applications to visualize
|
||||
the host or alter user
|
||||
interaction. Currently, the following
|
||||
chassis types are defined:
|
||||
the host or alter user interaction.
|
||||
Currently, the following chassis types
|
||||
are defined:
|
||||
<literal>desktop</literal>,
|
||||
<literal>laptop</literal>,
|
||||
<literal>server</literal>,
|
||||
<literal>tablet</literal>,
|
||||
<literal>handset</literal>, as well as
|
||||
<literal>handset</literal>,
|
||||
<literal>watch</literal>, as well as
|
||||
the special chassis types
|
||||
<literal>vm</literal> and
|
||||
<literal>container</literal> for
|
||||
virtualized systems that lack an
|
||||
immediate physical chassis. Pass an
|
||||
empty string to this operation to
|
||||
reset the chassis type to the default
|
||||
value which is determined from the
|
||||
firmware and possibly other
|
||||
parameters.</para></listitem>
|
||||
immediate physical chassis.</para>
|
||||
|
||||
<para>Pass an empty string to reset
|
||||
the chassis type to the default value
|
||||
which is determined from the firmware
|
||||
and possibly other parameters.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>set-deployment <replaceable>ENVIRONMENT</replaceable></command></term>
|
||||
|
||||
<listitem><para>Set the deployment
|
||||
environment
|
||||
description. <replaceable>ENVIRONMENT</replaceable>
|
||||
must be a single word without any
|
||||
control characters. One of the
|
||||
following is suggested:
|
||||
<literal>development</literal>,
|
||||
<literal>integration</literal>,
|
||||
<literal>staging</literal>,
|
||||
<literal>production</literal>.
|
||||
</para>
|
||||
|
||||
<para>Pass an empty string to reset to
|
||||
the default empty value.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>set-location <replaceable>LOCATION</replaceable></command></term>
|
||||
|
||||
<listitem><para>Set the location
|
||||
string for the system, if it is
|
||||
known. <replaceable>LOCATION</replaceable>
|
||||
should be a human-friendly, free-form
|
||||
string describing the physical
|
||||
location of the system, if it is known
|
||||
and applicable. This may be as generic
|
||||
as <literal>Berlin, Germany</literal>
|
||||
or as specific as <literal>Left Rack,
|
||||
2nd Shelf</literal>.</para>
|
||||
|
||||
<para>Pass an empty string to reset to
|
||||
the default empty value.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
@ -244,7 +287,8 @@
|
||||
<citerefentry><refentrytitle>hostname</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-hostnamed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
<citerefentry><refentrytitle>systemd-hostnamed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
|
||||
File diff suppressed because one or more lines are too long
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="systemd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd, init — systemd system and service manager</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">systemd [OPTIONS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">init [OPTIONS...] {COMMAND}</code> </p></div></div><div class="refsect1"><a name="idm214189898832"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>systemd is a system and service manager for
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="systemd"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd, init — systemd system and service manager</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">systemd [OPTIONS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">init [OPTIONS...] {COMMAND}</code> </p></div></div><div class="refsect1"><a name="idm214191869872"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>systemd is a system and service manager for
|
||||
Linux operating systems. When run as first process on
|
||||
boot (as PID 1), it acts as init system that brings
|
||||
up and maintains userspace services.</p><p>For compatibility with SysV, if systemd is called
|
||||
@ -34,7 +34,7 @@
|
||||
<code class="filename">system.conf</code>, otherwise
|
||||
<code class="filename">user.conf</code>. See
|
||||
<a href="systemd-system.conf.html"><span class="citerefentry"><span class="refentrytitle">systemd-system.conf</span>(5)</span></a>
|
||||
for more information.</p></div><div class="refsect1"><a name="idm214188084384"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--test"><span class="term"><code class="option">--test</code></span><a class="headerlink" title="Permalink to this term" href="#--test">¶</a></dt><dd><p>Determine startup
|
||||
for more information.</p></div><div class="refsect1"><a name="idm214191861296"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--test"><span class="term"><code class="option">--test</code></span><a class="headerlink" title="Permalink to this term" href="#--test">¶</a></dt><dd><p>Determine startup
|
||||
sequence, dump it and exit. This is an
|
||||
option useful for debugging
|
||||
only.</p></dd><dt id="--dump-configuration-items"><span class="term"><code class="option">--dump-configuration-items</code></span><a class="headerlink" title="Permalink to this term" href="#--dump-configuration-items">¶</a></dt><dd><p>Dump understood unit
|
||||
@ -81,13 +81,11 @@
|
||||
target. Argument must be one of
|
||||
<code class="option">console</code>,
|
||||
<code class="option">journal</code>,
|
||||
<code class="option">syslog</code>,
|
||||
<code class="option">kmsg</code>,
|
||||
<code class="option">journal-or-kmsg</code>,
|
||||
<code class="option">syslog-or-kmsg</code>,
|
||||
<code class="option">null</code>.</p></dd><dt id="--log-level="><span class="term"><code class="option">--log-level=</code></span><a class="headerlink" title="Permalink to this term" href="#--log-level=">¶</a></dt><dd><p>Set log level. As
|
||||
argument this accepts a numerical log
|
||||
level or the well-known <a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
level or the well-known <a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
|
||||
symbolic names (lowercase):
|
||||
<code class="option">emerg</code>,
|
||||
<code class="option">alert</code>,
|
||||
@ -131,7 +129,7 @@
|
||||
<code class="option">--default-standard-error=</code>
|
||||
to
|
||||
<code class="option">inherit</code>.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd></dl></div></div><div class="refsect1"><a name="idm214189143952"></a><h2 id="Concepts">Concepts<a class="headerlink" title="Permalink to this headline" href="#Concepts">¶</a></h2><p>systemd provides a dependency system between
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd></dl></div></div><div class="refsect1"><a name="idm214190798640"></a><h2 id="Concepts">Concepts<a class="headerlink" title="Permalink to this headline" href="#Concepts">¶</a></h2><p>systemd provides a dependency system between
|
||||
various entities called "units" of 12 different
|
||||
types. Units encapsulate various objects that are
|
||||
relevant for system boot-up and maintenance. The
|
||||
@ -254,7 +252,7 @@
|
||||
file system hierarchy (beneath
|
||||
<code class="filename">/sys/fs/cgroup/systemd/</code>), or in tools
|
||||
such as
|
||||
<a href="ps.html"><span class="citerefentry"><span class="refentrytitle">ps</span>(1)</span></a>
|
||||
<a href="http://man7.org/linux/man-pages/man1/ps.1.html"><span class="citerefentry"><span class="refentrytitle">ps</span>(1)</span></a>
|
||||
(<span class="command"><strong>ps xawf -eo pid,user,cgroup,args</strong></span>
|
||||
is particularly useful to list all processes and the
|
||||
systemd units they belong to.).</p><p>systemd is compatible with the SysV init system
|
||||
@ -304,7 +302,7 @@
|
||||
or initrd environment should implement the
|
||||
<a class="ulink" href="http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface" target="_top">Container
|
||||
Interface</a> or <a class="ulink" href="http://www.freedesktop.org/wiki/Software/systemd/InitrdInterface" target="_top">initrd
|
||||
Interface</a> specifications, respectively.</p></div><div class="refsect1"><a name="idm214189453632"></a><h2 id="Directories">Directories<a class="headerlink" title="Permalink to this headline" href="#Directories">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="System unit directories"><span class="term">System unit directories</span><a class="headerlink" title="Permalink to this term" href="#System%20unit%20directories">¶</a></dt><dd><p>The systemd system
|
||||
Interface</a> specifications, respectively.</p></div><div class="refsect1"><a name="idm214190748208"></a><h2 id="Directories">Directories<a class="headerlink" title="Permalink to this headline" href="#Directories">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="System unit directories"><span class="term">System unit directories</span><a class="headerlink" title="Permalink to this term" href="#System%20unit%20directories">¶</a></dt><dd><p>The systemd system
|
||||
manager reads unit configuration from
|
||||
various directories. Packages that
|
||||
want to install unit files shall place
|
||||
@ -368,7 +366,7 @@
|
||||
unit with a native unit configuration
|
||||
file cannot be started by activating it
|
||||
in the SysV runlevel link
|
||||
farm.</p></dd></dl></div></div><div class="refsect1"><a name="idm214189693872"></a><h2 id="Signals">Signals<a class="headerlink" title="Permalink to this headline" href="#Signals">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="SIGTERM"><span class="term"><code class="constant">SIGTERM</code></span><a class="headerlink" title="Permalink to this term" href="#SIGTERM">¶</a></dt><dd><p>Upon receiving this
|
||||
farm.</p></dd></dl></div></div><div class="refsect1"><a name="idm214190725744"></a><h2 id="Signals">Signals<a class="headerlink" title="Permalink to this headline" href="#Signals">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="SIGTERM"><span class="term"><code class="constant">SIGTERM</code></span><a class="headerlink" title="Permalink to this term" href="#SIGTERM">¶</a></dt><dd><p>Upon receiving this
|
||||
signal the systemd system manager
|
||||
serializes its state, reexecutes
|
||||
itself and deserializes the saved
|
||||
@ -468,25 +466,21 @@
|
||||
the kernel command
|
||||
line.</p></dd><dt id="SIGRTMIN+24"><span class="term"><code class="constant">SIGRTMIN+24</code></span><a class="headerlink" title="Permalink to this term" href="#SIGRTMIN+24">¶</a></dt><dd><p>Immediately exits the
|
||||
manager (only available for --user
|
||||
instances).</p></dd><dt id="SIGRTMIN+26"><span class="term"><code class="constant">SIGRTMIN+26</code>, </span><span class="term"><code class="constant">SIGRTMIN+27</code>, </span><span class="term"><code class="constant">SIGRTMIN+28</code>, </span><span class="term"><code class="constant">SIGRTMIN+29</code></span><a class="headerlink" title="Permalink to this term" href="#SIGRTMIN+26">¶</a></dt><dd><p>Sets the log level to
|
||||
"<code class="literal">journal-or-kmsg</code>"
|
||||
(or "<code class="literal">console</code>" on
|
||||
instances).</p></dd><dt id="SIGRTMIN+26"><span class="term"><code class="constant">SIGRTMIN+26</code>, </span><span class="term"><code class="constant">SIGRTMIN+27</code>, </span><span class="term"><code class="constant">SIGRTMIN+28</code></span><a class="headerlink" title="Permalink to this term" href="#SIGRTMIN+26">¶</a></dt><dd><p>Sets the log level to
|
||||
"<code class="literal">journal-or-kmsg</code>" (or
|
||||
"<code class="literal">console</code>" on
|
||||
<code class="constant">SIGRTMIN+27</code>,
|
||||
"<code class="literal">kmsg</code>" on
|
||||
<code class="constant">SIGRTMIN+28</code>,
|
||||
or "<code class="literal">syslog-or-kmsg</code>"
|
||||
on <code class="constant">SIGRTMIN+29</code>), as
|
||||
<code class="constant">SIGRTMIN+28</code>), as
|
||||
controlled via
|
||||
<code class="varname">systemd.log_target=journal-or-kmsg</code>
|
||||
(or <code class="varname">systemd.log_target=console</code>
|
||||
on <code class="constant">SIGRTMIN+27</code>,
|
||||
(or
|
||||
<code class="varname">systemd.log_target=console</code>
|
||||
on <code class="constant">SIGRTMIN+27</code> or
|
||||
<code class="varname">systemd.log_target=kmsg</code>
|
||||
on <code class="constant">SIGRTMIN+28</code>,
|
||||
or
|
||||
<code class="varname">systemd.log_target=syslog-or-kmsg</code>
|
||||
on <code class="constant">SIGRTMIN+29</code>) on
|
||||
the kernel command
|
||||
line.</p></dd></dl></div></div><div class="refsect1"><a name="idm214191284560"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$SYSTEMD_LOG_LEVEL"><span class="term"><code class="varname">$SYSTEMD_LOG_LEVEL</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_LOG_LEVEL">¶</a></dt><dd><p>systemd reads the
|
||||
on <code class="constant">SIGRTMIN+28</code>)
|
||||
on the kernel command
|
||||
line.</p></dd></dl></div></div><div class="refsect1"><a name="idm214190659360"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$SYSTEMD_LOG_LEVEL"><span class="term"><code class="varname">$SYSTEMD_LOG_LEVEL</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_LOG_LEVEL">¶</a></dt><dd><p>systemd reads the
|
||||
log level from this environment
|
||||
variable. This can be overridden with
|
||||
<code class="option">--log-level=</code>.</p></dd><dt id="$SYSTEMD_LOG_TARGET"><span class="term"><code class="varname">$SYSTEMD_LOG_TARGET</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_LOG_TARGET">¶</a></dt><dd><p>systemd reads the
|
||||
@ -518,9 +512,9 @@
|
||||
start-up completion notification. See
|
||||
<a href="sd_notify.html"><span class="citerefentry"><span class="refentrytitle">sd_notify</span>(3)</span></a>
|
||||
for more information.
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214191260432"></a><h2 id="Kernel Command Line">Kernel Command Line<a class="headerlink" title="Permalink to this headline" href="#Kernel%20Command%20Line">¶</a></h2><p>When run as system instance systemd parses a
|
||||
</p></dd></dl></div></div><div class="refsect1"><a name="idm214190635936"></a><h2 id="Kernel Command Line">Kernel Command Line<a class="headerlink" title="Permalink to this headline" href="#Kernel%20Command%20Line">¶</a></h2><p>When run as system instance systemd parses a
|
||||
number of kernel command line
|
||||
arguments<a href="#ftn.idm214191259376" class="footnote" name="idm214191259376"><sup class="footnote">[1]</sup></a>:</p><div class="variablelist"><dl class="variablelist"><dt id="systemd.unit="><span class="term"><code class="varname">systemd.unit=</code>, </span><span class="term"><code class="varname">rd.systemd.unit=</code></span><a class="headerlink" title="Permalink to this term" href="#systemd.unit=">¶</a></dt><dd><p>Overrides the unit to
|
||||
arguments<a href="#ftn.idm214190634912" class="footnote" name="idm214190634912"><sup class="footnote">[1]</sup></a>:</p><div class="variablelist"><dl class="variablelist"><dt id="systemd.unit="><span class="term"><code class="varname">systemd.unit=</code>, </span><span class="term"><code class="varname">rd.systemd.unit=</code></span><a class="headerlink" title="Permalink to this term" href="#systemd.unit=">¶</a></dt><dd><p>Overrides the unit to
|
||||
activate on boot. Defaults to
|
||||
<code class="filename">default.target</code>. This
|
||||
may be used to temporarily boot into a
|
||||
@ -598,11 +592,12 @@
|
||||
debug output. Passing this option
|
||||
hence turns on the debug output from
|
||||
both the system manager and the
|
||||
kernel.</p></dd><dt id="-b"><span class="term"><code class="varname">-b</code>, </span><span class="term"><code class="varname">emergency</code></span><a class="headerlink" title="Permalink to this term" href="#-b">¶</a></dt><dd><p>Boot into emergency
|
||||
kernel.</p></dd><dt id="emergency"><span class="term"><code class="varname">emergency</code>, </span><span class="term"><code class="varname">-b</code></span><a class="headerlink" title="Permalink to this term" href="#emergency">¶</a></dt><dd><p>Boot into emergency
|
||||
mode. This is equivalent to
|
||||
<code class="varname">systemd.unit=emergency.target</code>
|
||||
and provided for compatibility
|
||||
reasons and to be easier to type.</p></dd><dt id="single"><span class="term"><code class="varname">single</code>, </span><span class="term"><code class="varname">s</code>, </span><span class="term"><code class="varname">S</code>, </span><span class="term"><code class="varname">1</code></span><a class="headerlink" title="Permalink to this term" href="#single">¶</a></dt><dd><p>Boot into rescue
|
||||
and provided for compatibility reasons
|
||||
and to be easier to
|
||||
type.</p></dd><dt id="rescue"><span class="term"><code class="varname">rescue</code>, </span><span class="term"><code class="varname">single</code>, </span><span class="term"><code class="varname">s</code>, </span><span class="term"><code class="varname">S</code>, </span><span class="term"><code class="varname">1</code></span><a class="headerlink" title="Permalink to this term" href="#rescue">¶</a></dt><dd><p>Boot into rescue
|
||||
mode. This is equivalent to
|
||||
<code class="varname">systemd.unit=rescue.target</code>
|
||||
and provided for compatibility reasons
|
||||
@ -626,7 +621,7 @@
|
||||
</p></dd></dl></div><p>For other kernel command line parameters
|
||||
understood by components of the core OS, please refer
|
||||
to
|
||||
<a href="kernel-command-line.html"><span class="citerefentry"><span class="refentrytitle">kernel-command-line</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm214187977552"></a><h2 id="Sockets and FIFOs">Sockets and FIFOs<a class="headerlink" title="Permalink to this headline" href="#Sockets%20and%20FIFOs">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/run/systemd/notify"><span class="term"><code class="filename">/run/systemd/notify</code></span><a class="headerlink" title="Permalink to this term" href="#/run/systemd/notify">¶</a></dt><dd><p>Daemon status
|
||||
<a href="kernel-command-line.html"><span class="citerefentry"><span class="refentrytitle">kernel-command-line</span>(7)</span></a>.</p></div><div class="refsect1"><a name="idm214190574624"></a><h2 id="Sockets and FIFOs">Sockets and FIFOs<a class="headerlink" title="Permalink to this headline" href="#Sockets%20and%20FIFOs">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="/run/systemd/notify"><span class="term"><code class="filename">/run/systemd/notify</code></span><a class="headerlink" title="Permalink to this term" href="#/run/systemd/notify">¶</a></dt><dd><p>Daemon status
|
||||
notification socket. This is an
|
||||
<code class="constant">AF_UNIX</code> datagram socket and is used to
|
||||
implement the daemon notification
|
||||
@ -649,7 +644,7 @@
|
||||
unit. This is a named pipe in the file
|
||||
system. This interface is obsolete and
|
||||
should not be used in new
|
||||
applications.</p></dd></dl></div></div><div class="refsect1"><a name="idm214187964368"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
applications.</p></dd></dl></div></div><div class="refsect1"><a name="idm214190561440"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
The <a class="ulink" href="http://www.freedesktop.org/wiki/Software/systemd/" target="_top">systemd Homepage</a>,
|
||||
<a href="systemd-system.conf.html"><span class="citerefentry"><span class="refentrytitle">systemd-system.conf</span>(5)</span></a>,
|
||||
<a href="locale.conf.html"><span class="citerefentry"><span class="refentrytitle">locale.conf</span>(5)</span></a>,
|
||||
@ -660,11 +655,11 @@
|
||||
<a href="sd-daemon.html"><span class="citerefentry"><span class="refentrytitle">sd-daemon</span>(3)</span></a>,
|
||||
<a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>,
|
||||
<a href="systemd.special.html"><span class="citerefentry"><span class="refentrytitle">systemd.special</span>(5)</span></a>,
|
||||
<a href="pkg-config.html"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="http://linux.die.net/man/1/pkg-config"><span class="citerefentry"><span class="refentrytitle">pkg-config</span>(1)</span></a>,
|
||||
<a href="kernel-command-line.html"><span class="citerefentry"><span class="refentrytitle">kernel-command-line</span>(7)</span></a>,
|
||||
<a href="bootup.html"><span class="citerefentry"><span class="refentrytitle">bootup</span>(7)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man7/bootup.7.html"><span class="citerefentry"><span class="refentrytitle">bootup</span>(7)</span></a>,
|
||||
<a href="systemd.directives.html"><span class="citerefentry"><span class="refentrytitle">systemd.directives</span>(7)</span></a>
|
||||
</p></div><div class="footnotes"><br><hr style="width:100; text-align:left;margin-left: 0"><div id="ftn.idm214191259376" class="footnote"><p><a href="#idm214191259376" class="para"><sup class="para">[1] </sup></a>If run inside a Linux
|
||||
</p></div><div class="footnotes"><br><hr style="width:100; text-align:left;margin-left: 0"><div id="ftn.idm214190634912" class="footnote"><p><a href="#idm214190634912" class="para"><sup class="para">[1] </sup></a>If run inside a Linux
|
||||
container these arguments may be passed as command
|
||||
line arguments to systemd itself, next to any of the
|
||||
command line options listed in the Options section
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "JOURNALCTL" "1" "" "systemd 215" "journalctl"
|
||||
.TH "JOURNALCTL" "1" "" "systemd 217" "journalctl"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -38,9 +38,9 @@ If one or more match arguments are passed, the output is filtered accordingly\&.
|
||||
"FIELD=VALUE", e\&.g\&.
|
||||
"_SYSTEMD_UNIT=httpd\&.service", referring to the components of a structured journal entry\&. See
|
||||
\fBsystemd.journal-fields\fR(7)
|
||||
for a list of well\-known fields\&. If multiple matches are specified matching different fields, the log entries are filtered by both, i\&.e\&. the resulting output will show only entries matching all the specified matches of this kind\&. If two matches apply to the same field, then they are automatically matched as alternatives, i\&.e\&. the resulting output will show entries matching any of the specified matches for the same field\&. Finally, if the character
|
||||
for a list of well\-known fields\&. If multiple matches are specified matching different fields, the log entries are filtered by both, i\&.e\&. the resulting output will show only entries matching all the specified matches of this kind\&. If two matches apply to the same field, then they are automatically matched as alternatives, i\&.e\&. the resulting output will show entries matching any of the specified matches for the same field\&. Finally, the character
|
||||
"+"
|
||||
appears as a separate word on the command line, all matches before and after are combined in a disjunction (i\&.e\&. logical OR)\&.
|
||||
may appears as a separate word between other terms on the command line\&. This causes all matches before and after to be combined in a disjunction (i\&.e\&. logical OR)\&.
|
||||
.PP
|
||||
As shortcuts for a few types of field/value matches, file paths may be specified\&. If a file path refers to an executable file, this is equivalent to an
|
||||
"_EXE="
|
||||
@ -48,8 +48,19 @@ match for the canonicalized binary path\&. Similarly, if a path refers to a devi
|
||||
"_KERNEL_DEVICE="
|
||||
match for the device\&.
|
||||
.PP
|
||||
Additional constraints may be added using options
|
||||
\fB\-\-boot\fR,
|
||||
\fB\-\-unit=\fR, etc, to further limit what entries will be shown (logical AND)\&.
|
||||
.PP
|
||||
Output is interleaved from all accessible journal files, whether they are rotated or currently being written, and regardless of whether they belong to the system itself or are accessible user journals\&.
|
||||
.PP
|
||||
The set of journal files which will be used can be modified using the
|
||||
\fB\-\-user\fR,
|
||||
\fB\-\-system\fR,
|
||||
\fB\-\-directory\fR, and
|
||||
\fB\-\-file\fR
|
||||
options, see below\&.
|
||||
.PP
|
||||
All users are granted access to their private per\-user journals\&. However, by default, only root and users who are members of the
|
||||
"systemd\-journal"
|
||||
group get access to the system journal and the journals of other users\&.
|
||||
@ -60,7 +71,7 @@ by default, and long lines are "truncated" to screen width\&. The hidden part ca
|
||||
\fB\-\-no\-pager\fR
|
||||
option and the "Environment" section below\&.
|
||||
.PP
|
||||
When outputing to a tty, lines are colored according to priority: lines of level ERROR and higher are colored red; lines of level NOTICE and higher are highlighted; other lines are displayed normally\&.
|
||||
When outputting to a tty, lines are colored according to priority: lines of level ERROR and higher are colored red; lines of level NOTICE and higher are highlighted; other lines are displayed normally\&.
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
The following options are understood:
|
||||
@ -91,7 +102,9 @@ Immediately jump to the end of the journal inside the implied pager tool\&. This
|
||||
\fB\-n1000\fR
|
||||
to guarantee that the pager will not buffer logs of unbounded size\&. This may be overridden with an explicit
|
||||
\fB\-n\fR
|
||||
with some other numeric value on the command line\&. Note that this option is only supported for the
|
||||
with some other numeric value while
|
||||
\fB\-nall\fR
|
||||
will disable this cap\&. Note that this option is only supported for the
|
||||
\fBless\fR(1)
|
||||
pager\&.
|
||||
.RE
|
||||
@ -100,7 +113,9 @@ pager\&.
|
||||
.RS 4
|
||||
Show the most recent journal events and limit the number of events shown\&. If
|
||||
\fB\-\-follow\fR
|
||||
is used, this option is implied\&. The argument, a positive integer, is optional, and defaults to 10\&.
|
||||
is used, this option is implied\&. The argument is a positive integer or
|
||||
"all"
|
||||
to disable line limiting\&. The default value is 10 if no argument is given\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-no\-tail\fR
|
||||
@ -174,6 +189,11 @@ generates a very terse output, only showing the actual message of each journal e
|
||||
.RE
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-utc\fR
|
||||
.RS 4
|
||||
Express time in Coordinated Universal Time (UTC)\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-x\fR, \fB\-\-catalog\fR
|
||||
.RS 4
|
||||
Augment log lines with explanation texts from the message catalog\&. This will add explanatory help texts to log messages in the output where this is available\&. These short help texts will explain the context of an error or log event, possible solutions, as well as pointers to support forums, developer documentation, and any other relevant manuals\&. Note that help texts are not available for all messages, but only for selected ones\&. For more information on the message catalog, please refer to the
|
||||
@ -248,10 +268,22 @@ and adds the match
|
||||
"_TRANSPORT=kernel"\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-t\fR, \fB\-\-identifier=\fR\fB\fISYSLOG_IDENTIFIER\fR\fR\fB|\fR\fB\fIPATTERN\fR\fR
|
||||
.RS 4
|
||||
Show messages for the specified syslog identifier
|
||||
\fISYSLOG_IDENTIFIER\fR, or for any of the messages with a
|
||||
"SYSLOG_IDENTIFIER"
|
||||
matched by
|
||||
\fIPATTERN\fR\&.
|
||||
.sp
|
||||
This parameter can be specified multiple times\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-u\fR, \fB\-\-unit=\fR\fB\fIUNIT\fR\fR\fB|\fR\fB\fIPATTERN\fR\fR
|
||||
.RS 4
|
||||
Show messages for the specified systemd unit
|
||||
\fIUNIT\fR, or for any of the units matched by
|
||||
\fIUNIT\fR
|
||||
(such as a service unit), or for any of the units matched by
|
||||
\fIPATTERN\fR\&. If a pattern is specified, a list of unit names found in the journal is compared with the specified pattern and all that match are used\&. For each unit name, a match is added for messages from the unit ("_SYSTEMD_UNIT=\fIUNIT\fR"), along with additional matches for messages from systemd and messages about coredumps for the specified unit\&.
|
||||
.sp
|
||||
This parameter can be specified multiple times\&.
|
||||
@ -453,6 +485,14 @@ Specifies the FSS verification key to use for the
|
||||
operation\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-flush\fR
|
||||
.RS 4
|
||||
Asks the Journal daemon to flush any log data stored in
|
||||
/run/systemd/log
|
||||
into
|
||||
/var/systemd/log, if persistent storage is enabled\&. This call does not return until the operation is complete\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
.RS 4
|
||||
Print a short help text and exit\&.
|
||||
@ -589,11 +629,25 @@ journalctl \-k \-b \-1
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
Show a live log display from a system service
|
||||
apache\&.service:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
journalctl \-f \-u apache
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "SEE ALSO"
|
||||
.PP
|
||||
\fBsystemd\fR(1),
|
||||
\fBsystemd-journald.service\fR(8),
|
||||
\fBsystemctl\fR(1),
|
||||
\fBcoredumpctl\fR(1),
|
||||
\fBsystemd.journal-fields\fR(7),
|
||||
\fBjournald.conf\fR(5)
|
||||
.SH "NOTES"
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="journalctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>journalctl — Query the systemd journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">journalctl</code> [OPTIONS...] [MATCHES...]</p></div></div><div class="refsect1"><a name="idm214192081472"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>journalctl</strong></span> may be used to
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="journalctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>journalctl — Query the systemd journal</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">journalctl</code> [OPTIONS...] [MATCHES...]</p></div></div><div class="refsect1"><a name="idm214180318720"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>journalctl</strong></span> may be used to
|
||||
query the contents of the
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
|
||||
journal as written by
|
||||
@ -40,20 +40,27 @@
|
||||
field, then they are automatically matched as
|
||||
alternatives, i.e. the resulting output will show
|
||||
entries matching any of the specified matches for the
|
||||
same field. Finally, if the character
|
||||
"<code class="literal">+</code>" appears as a separate word on the
|
||||
command line, all matches before and after are combined
|
||||
in a disjunction (i.e. logical OR).</p><p>As shortcuts for a few types of field/value
|
||||
same field. Finally, the character
|
||||
"<code class="literal">+</code>" may appears as a separate word
|
||||
between other terms on the command line. This causes
|
||||
all matches before and after to be combined in a
|
||||
disjunction (i.e. logical OR).</p><p>As shortcuts for a few types of field/value
|
||||
matches, file paths may be specified. If a file path
|
||||
refers to an executable file, this is equivalent to an
|
||||
"<code class="literal">_EXE=</code>" match for the canonicalized
|
||||
binary path. Similarly, if a path refers to a device
|
||||
node, this is equivalent to a
|
||||
"<code class="literal">_KERNEL_DEVICE=</code>" match for the
|
||||
device.</p><p>Output is interleaved from all accessible
|
||||
device.</p><p>Additional constraints may be added using options
|
||||
<code class="option">--boot</code>, <code class="option">--unit=</code>,
|
||||
etc, to further limit what entries will be shown
|
||||
(logical AND).</p><p>Output is interleaved from all accessible
|
||||
journal files, whether they are rotated or currently
|
||||
being written, and regardless of whether they belong to the
|
||||
system itself or are accessible user journals.</p><p>All users are granted access to their private
|
||||
system itself or are accessible user journals.</p><p>The set of journal files which will be used
|
||||
can be modified using the <code class="option">--user</code>,
|
||||
<code class="option">--system</code>, <code class="option">--directory</code>,
|
||||
and <code class="option">--file</code> options, see below.</p><p>All users are granted access to their private
|
||||
per-user journals. However, by default, only root and
|
||||
users who are members of the "<code class="literal">systemd-journal</code>"
|
||||
group get access to the system journal and the
|
||||
@ -63,11 +70,11 @@
|
||||
viewed by using the left-arrow and right-arrow
|
||||
keys. Paging can be disabled; see the
|
||||
<code class="option">--no-pager</code> option and the "Environment"
|
||||
section below.</p><p>When outputing to a tty, lines are colored
|
||||
section below.</p><p>When outputting to a tty, lines are colored
|
||||
according to priority: lines of level ERROR and higher
|
||||
are colored red; lines of level NOTICE and higher are
|
||||
highlighted; other lines are displayed normally.
|
||||
</p></div><div class="refsect1"><a name="idm214193028176"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-full"><span class="term"><code class="option">--no-full</code>, </span><span class="term"><code class="option">--full</code>, </span><span class="term"><code class="option">-l</code></span><a class="headerlink" title="Permalink to this term" href="#--no-full">¶</a></dt><dd><p>Ellipsize fields when
|
||||
</p></div><div class="refsect1"><a name="idm214184199968"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="--no-full"><span class="term"><code class="option">--no-full</code>, </span><span class="term"><code class="option">--full</code>, </span><span class="term"><code class="option">-l</code></span><a class="headerlink" title="Permalink to this term" href="#--no-full">¶</a></dt><dd><p>Ellipsize fields when
|
||||
they do not fit in available columns.
|
||||
The default is to show full fields,
|
||||
allowing them to wrap or be truncated
|
||||
@ -87,17 +94,18 @@
|
||||
that the pager will not buffer logs of
|
||||
unbounded size. This may be overridden
|
||||
with an explicit <code class="option">-n</code>
|
||||
with some other numeric value on the
|
||||
command line. Note that this option is
|
||||
only supported for the
|
||||
<a href="less.html"><span class="citerefentry"><span class="refentrytitle">less</span>(1)</span></a>
|
||||
with some other numeric value while
|
||||
<code class="option">-nall</code> will disable this cap.
|
||||
Note that this option is only supported for the
|
||||
<a href="http://man7.org/linux/man-pages/man1/less.1.html"><span class="citerefentry"><span class="refentrytitle">less</span>(1)</span></a>
|
||||
pager.</p></dd><dt id="-n"><span class="term"><code class="option">-n</code>, </span><span class="term"><code class="option">--lines=</code></span><a class="headerlink" title="Permalink to this term" href="#-n">¶</a></dt><dd><p>Show the most recent
|
||||
journal events and limit the number of
|
||||
events shown. If
|
||||
<code class="option">--follow</code> is used,
|
||||
this option is implied. The argument,
|
||||
a positive integer, is optional, and
|
||||
defaults to 10. </p></dd><dt id="--no-tail"><span class="term"><code class="option">--no-tail</code></span><a class="headerlink" title="Permalink to this term" href="#--no-tail">¶</a></dt><dd><p>Show all stored output
|
||||
this option is implied. The argument is
|
||||
a positive integer or "<code class="literal">all</code>"
|
||||
to disable line limiting. The default value is
|
||||
10 if no argument is given.</p></dd><dt id="--no-tail"><span class="term"><code class="option">--no-tail</code></span><a class="headerlink" title="Permalink to this term" href="#--no-tail">¶</a></dt><dd><p>Show all stored output
|
||||
lines, even in follow mode. Undoes the
|
||||
effect of
|
||||
<code class="option">--lines=</code>.</p></dd><dt id="-r"><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--reverse</code></span><a class="headerlink" title="Permalink to this term" href="#-r">¶</a></dt><dd><p>Reverse output so that the newest
|
||||
@ -191,7 +199,8 @@
|
||||
message of each journal
|
||||
entry with no metadata,
|
||||
not even a timestamp.
|
||||
</p></dd></dl></div></dd><dt id="-x"><span class="term"><code class="option">-x</code>, </span><span class="term"><code class="option">--catalog</code></span><a class="headerlink" title="Permalink to this term" href="#-x">¶</a></dt><dd><p>Augment log lines with
|
||||
</p></dd></dl></div></dd><dt id="--utc"><span class="term"><code class="option">--utc</code></span><a class="headerlink" title="Permalink to this term" href="#--utc">¶</a></dt><dd><p>Express time in Coordinated Universal
|
||||
Time (UTC).</p></dd><dt id="-x"><span class="term"><code class="option">-x</code>, </span><span class="term"><code class="option">--catalog</code></span><a class="headerlink" title="Permalink to this term" href="#-x">¶</a></dt><dd><p>Augment log lines with
|
||||
explanation texts from the message
|
||||
catalog. This will add explanatory
|
||||
help texts to log messages in the
|
||||
@ -257,10 +266,16 @@
|
||||
</p></dd><dt id="-k"><span class="term"><code class="option">-k</code>, </span><span class="term"><code class="option">--dmesg</code></span><a class="headerlink" title="Permalink to this term" href="#-k">¶</a></dt><dd><p>Show only kernel messages. This
|
||||
implies <code class="option">-b</code> and adds the match
|
||||
"<code class="literal">_TRANSPORT=kernel</code>".
|
||||
</p></dd><dt id="-u"><span class="term"><code class="option">-u</code>, </span><span class="term"><code class="option">--unit=<em class="replaceable"><code>UNIT</code></em>|<em class="replaceable"><code>PATTERN</code></em></code></span><a class="headerlink" title="Permalink to this term" href="#-u">¶</a></dt><dd><p>Show messages for the
|
||||
</p></dd><dt id="-t"><span class="term"><code class="option">-t</code>, </span><span class="term"><code class="option">--identifier=<em class="replaceable"><code>SYSLOG_IDENTIFIER</code></em>|<em class="replaceable"><code>PATTERN</code></em></code></span><a class="headerlink" title="Permalink to this term" href="#-t">¶</a></dt><dd><p>Show messages for the
|
||||
specified syslog identifier
|
||||
<em class="replaceable"><code>SYSLOG_IDENTIFIER</code></em>, or
|
||||
for any of the messages with a "<code class="literal">SYSLOG_IDENTIFIER</code>"
|
||||
matched by <em class="replaceable"><code>PATTERN</code></em>.</p><p>This parameter can be specified
|
||||
multiple times.</p></dd><dt id="-u"><span class="term"><code class="option">-u</code>, </span><span class="term"><code class="option">--unit=<em class="replaceable"><code>UNIT</code></em>|<em class="replaceable"><code>PATTERN</code></em></code></span><a class="headerlink" title="Permalink to this term" href="#-u">¶</a></dt><dd><p>Show messages for the
|
||||
specified systemd unit
|
||||
<em class="replaceable"><code>UNIT</code></em>, or
|
||||
for any of the units matched by
|
||||
<em class="replaceable"><code>UNIT</code></em> (such
|
||||
as a service unit), or for any of the
|
||||
units matched by
|
||||
<em class="replaceable"><code>PATTERN</code></em>.
|
||||
If a pattern is specified, a list of
|
||||
unit names found in the journal is
|
||||
@ -291,7 +306,7 @@
|
||||
the form FROM..TO. The log levels are
|
||||
the usual syslog log levels as
|
||||
documented in
|
||||
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>,
|
||||
<a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>,
|
||||
i.e. "<code class="literal">emerg</code>" (0),
|
||||
"<code class="literal">alert</code>" (1),
|
||||
"<code class="literal">crit</code>" (2),
|
||||
@ -456,9 +471,17 @@
|
||||
verified.</p></dd><dt id="--verify-key="><span class="term"><code class="option">--verify-key=</code></span><a class="headerlink" title="Permalink to this term" href="#--verify-key=">¶</a></dt><dd><p>Specifies the FSS
|
||||
verification key to use for the
|
||||
<code class="option">--verify</code>
|
||||
operation.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div></div><div class="refsect1"><a name="idm214193157888"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned; otherwise, a non-zero
|
||||
failure code is returned.</p></div><div class="refsect1"><a name="idm214181682304"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$SYSTEMD_PAGER"><span class="term"><code class="varname">$SYSTEMD_PAGER</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_PAGER">¶</a></dt><dd><p>Pager to use when
|
||||
operation.</p></dd><dt id="--flush"><span class="term"><code class="option">--flush</code></span><a class="headerlink" title="Permalink to this term" href="#--flush">¶</a></dt><dd><p>Asks the Journal
|
||||
daemon to flush any log data stored in
|
||||
<code class="filename">/run/systemd/log</code>
|
||||
into
|
||||
<code class="filename">/var/systemd/log</code>,
|
||||
if persistent storage is enabled. This
|
||||
call does not return until the
|
||||
operation is
|
||||
complete.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
||||
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div></div><div class="refsect1"><a name="idm214179111664"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned; otherwise, a non-zero
|
||||
failure code is returned.</p></div><div class="refsect1"><a name="idm214170766464"></a><h2 id="Environment">Environment<a class="headerlink" title="Permalink to this headline" href="#Environment">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$SYSTEMD_PAGER"><span class="term"><code class="varname">$SYSTEMD_PAGER</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_PAGER">¶</a></dt><dd><p>Pager to use when
|
||||
<code class="option">--no-pager</code> is not given;
|
||||
overrides <code class="varname">$PAGER</code>. Setting
|
||||
this to an empty string or the value
|
||||
@ -466,16 +489,17 @@
|
||||
<code class="option">--no-pager</code>.</p></dd><dt id="$SYSTEMD_LESS"><span class="term"><code class="varname">$SYSTEMD_LESS</code></span><a class="headerlink" title="Permalink to this term" href="#%24SYSTEMD_LESS">¶</a></dt><dd><p>Override the default
|
||||
options passed to
|
||||
<span class="command"><strong>less</strong></span>
|
||||
("<code class="literal">FRSXMK</code>").</p></dd></dl></div></div><div class="refsect1"><a name="idm214193156064"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Without arguments, all collected logs are shown
|
||||
("<code class="literal">FRSXMK</code>").</p></dd></dl></div></div><div class="refsect1"><a name="idm214179109904"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>Without arguments, all collected logs are shown
|
||||
unfiltered:</p><pre class="programlisting">journalctl</pre><p>With one match specified, all entries with a field matching the expression are shown:</p><pre class="programlisting">journalctl _SYSTEMD_UNIT=avahi-daemon.service</pre><p>If two different fields are matched, only entries matching both expressions at the same time are shown:</p><pre class="programlisting">journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097</pre><p>If two matches refer to the same field, all entries matching either expression are shown:</p><pre class="programlisting">journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service</pre><p>If the separator "<code class="literal">+</code>" is used,
|
||||
two expressions may be combined in a logical OR. The
|
||||
following will show all messages from the Avahi
|
||||
service process with the PID 28097 plus all messages
|
||||
from the D-Bus service (from any of its
|
||||
processes):</p><pre class="programlisting">journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service</pre><p>Show all logs generated by the D-Bus executable:</p><pre class="programlisting">journalctl /usr/bin/dbus-daemon</pre><p>Show all logs of the kernel device node <code class="filename">/dev/sda</code>:</p><pre class="programlisting">journalctl /dev/sda</pre><p>Show all kernel logs from previous boot:</p><pre class="programlisting">journalctl -k -b -1</pre></div><div class="refsect1"><a name="idm214193144192"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
processes):</p><pre class="programlisting">journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service</pre><p>Show all logs generated by the D-Bus executable:</p><pre class="programlisting">journalctl /usr/bin/dbus-daemon</pre><p>Show all logs of the kernel device node <code class="filename">/dev/sda</code>:</p><pre class="programlisting">journalctl /dev/sda</pre><p>Show all kernel logs from previous boot:</p><pre class="programlisting">journalctl -k -b -1</pre><p>Show a live log display from a system service <code class="filename">apache.service</code>:</p><pre class="programlisting">journalctl -f -u apache</pre></div><div class="refsect1"><a name="idm214179096960"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemd-journald.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>,
|
||||
<a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
|
||||
<a href="coredumpctl.html"><span class="citerefentry"><span class="refentrytitle">coredumpctl</span>(1)</span></a>,
|
||||
<a href="systemd.journal-fields.html"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>,
|
||||
<a href="journald.conf.html"><span class="citerefentry"><span class="refentrytitle">journald.conf</span>(5)</span></a>
|
||||
</p></div></div></body></html>
|
||||
|
||||
@ -84,10 +84,11 @@
|
||||
field, then they are automatically matched as
|
||||
alternatives, i.e. the resulting output will show
|
||||
entries matching any of the specified matches for the
|
||||
same field. Finally, if the character
|
||||
<literal>+</literal> appears as a separate word on the
|
||||
command line, all matches before and after are combined
|
||||
in a disjunction (i.e. logical OR).</para>
|
||||
same field. Finally, the character
|
||||
<literal>+</literal> may appears as a separate word
|
||||
between other terms on the command line. This causes
|
||||
all matches before and after to be combined in a
|
||||
disjunction (i.e. logical OR).</para>
|
||||
|
||||
<para>As shortcuts for a few types of field/value
|
||||
matches, file paths may be specified. If a file path
|
||||
@ -98,11 +99,21 @@
|
||||
<literal>_KERNEL_DEVICE=</literal> match for the
|
||||
device.</para>
|
||||
|
||||
<para>Additional constraints may be added using options
|
||||
<option>--boot</option>, <option>--unit=</option>,
|
||||
etc, to further limit what entries will be shown
|
||||
(logical AND).</para>
|
||||
|
||||
<para>Output is interleaved from all accessible
|
||||
journal files, whether they are rotated or currently
|
||||
being written, and regardless of whether they belong to the
|
||||
system itself or are accessible user journals.</para>
|
||||
|
||||
<para>The set of journal files which will be used
|
||||
can be modified using the <option>--user</option>,
|
||||
<option>--system</option>, <option>--directory</option>,
|
||||
and <option>--file</option> options, see below.</para>
|
||||
|
||||
<para>All users are granted access to their private
|
||||
per-user journals. However, by default, only root and
|
||||
users who are members of the <literal>systemd-journal</literal>
|
||||
@ -117,7 +128,7 @@
|
||||
<option>--no-pager</option> option and the "Environment"
|
||||
section below.</para>
|
||||
|
||||
<para>When outputing to a tty, lines are colored
|
||||
<para>When outputting to a tty, lines are colored
|
||||
according to priority: lines of level ERROR and higher
|
||||
are colored red; lines of level NOTICE and higher are
|
||||
highlighted; other lines are displayed normally.
|
||||
@ -178,10 +189,10 @@
|
||||
that the pager will not buffer logs of
|
||||
unbounded size. This may be overridden
|
||||
with an explicit <option>-n</option>
|
||||
with some other numeric value on the
|
||||
command line. Note that this option is
|
||||
only supported for the
|
||||
<citerefentry><refentrytitle>less</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
with some other numeric value while
|
||||
<option>-nall</option> will disable this cap.
|
||||
Note that this option is only supported for the
|
||||
<citerefentry project='man-pages'><refentrytitle>less</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
pager.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
@ -193,9 +204,10 @@
|
||||
journal events and limit the number of
|
||||
events shown. If
|
||||
<option>--follow</option> is used,
|
||||
this option is implied. The argument,
|
||||
a positive integer, is optional, and
|
||||
defaults to 10. </para></listitem>
|
||||
this option is implied. The argument is
|
||||
a positive integer or <literal>all</literal>
|
||||
to disable line limiting. The default value is
|
||||
10 if no argument is given.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
@ -367,6 +379,13 @@
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>--utc</option></term>
|
||||
|
||||
<listitem><para>Express time in Coordinated Universal
|
||||
Time (UTC).</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>-x</option></term>
|
||||
<term><option>--catalog</option></term>
|
||||
@ -486,14 +505,29 @@
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>-t</option></term>
|
||||
<term><option>--identifier=<replaceable>SYSLOG_IDENTIFIER</replaceable>|<replaceable>PATTERN</replaceable></option></term>
|
||||
|
||||
<listitem><para>Show messages for the
|
||||
specified syslog identifier
|
||||
<replaceable>SYSLOG_IDENTIFIER</replaceable>, or
|
||||
for any of the messages with a <literal>SYSLOG_IDENTIFIER</literal>
|
||||
matched by <replaceable>PATTERN</replaceable>.</para>
|
||||
|
||||
<para>This parameter can be specified
|
||||
multiple times.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>-u</option></term>
|
||||
<term><option>--unit=<replaceable>UNIT</replaceable>|<replaceable>PATTERN</replaceable></option></term>
|
||||
|
||||
<listitem><para>Show messages for the
|
||||
specified systemd unit
|
||||
<replaceable>UNIT</replaceable>, or
|
||||
for any of the units matched by
|
||||
<replaceable>UNIT</replaceable> (such
|
||||
as a service unit), or for any of the
|
||||
units matched by
|
||||
<replaceable>PATTERN</replaceable>.
|
||||
If a pattern is specified, a list of
|
||||
unit names found in the journal is
|
||||
@ -540,7 +574,7 @@
|
||||
the form FROM..TO. The log levels are
|
||||
the usual syslog log levels as
|
||||
documented in
|
||||
<citerefentry><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
||||
i.e. <literal>emerg</literal> (0),
|
||||
<literal>alert</literal> (1),
|
||||
<literal>crit</literal> (2),
|
||||
@ -844,6 +878,20 @@
|
||||
operation.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><option>--flush</option></term>
|
||||
|
||||
<listitem><para>Asks the Journal
|
||||
daemon to flush any log data stored in
|
||||
<filename>/run/systemd/log</filename>
|
||||
into
|
||||
<filename>/var/systemd/log</filename>,
|
||||
if persistent storage is enabled. This
|
||||
call does not return until the
|
||||
operation is
|
||||
complete.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<xi:include href="standard-options.xml" xpointer="help" />
|
||||
<xi:include href="standard-options.xml" xpointer="version" />
|
||||
<xi:include href="standard-options.xml" xpointer="no-pager" />
|
||||
@ -900,6 +948,10 @@
|
||||
|
||||
<programlisting>journalctl -k -b -1</programlisting>
|
||||
|
||||
<para>Show a live log display from a system service <filename>apache.service</filename>:</para>
|
||||
|
||||
<programlisting>journalctl -f -u apache</programlisting>
|
||||
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
@ -908,6 +960,7 @@
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>coredumpctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd.journal-fields</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
</para>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "JOURNALD\&.CONF" "5" "" "systemd 215" "journald.conf"
|
||||
.TH "JOURNALD\&.CONF" "5" "" "systemd 217" "journald.conf"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -188,7 +188,7 @@ The timeout before synchronizing journal files to disk\&. After syncing, journal
|
||||
.PP
|
||||
\fIForwardToSyslog=\fR, \fIForwardToKMsg=\fR, \fIForwardToConsole=\fR, \fIForwardToWall=\fR
|
||||
.RS 4
|
||||
Control whether log messages received by the journal daemon shall be forwarded to a traditional syslog daemon, to the kernel log buffer (kmsg), to the system console, or sent as wall messages to all logged\-in users\&. These options take boolean arguments\&. If forwarding to syslog is enabled but no syslog daemon is running, the respective option has no effect\&. By default, only forwarding to syslog and wall is enabled\&. These settings may be overridden at boot time with the kernel command line options
|
||||
Control whether log messages received by the journal daemon shall be forwarded to a traditional syslog daemon, to the kernel log buffer (kmsg), to the system console, or sent as wall messages to all logged\-in users\&. These options take boolean arguments\&. If forwarding to syslog is enabled but no syslog daemon is running, the respective option has no effect\&. By default, only forwarding wall is enabled\&. These settings may be overridden at boot time with the kernel command line options
|
||||
"systemd\&.journald\&.forward_to_syslog=",
|
||||
"systemd\&.journald\&.forward_to_kmsg=",
|
||||
"systemd\&.journald\&.forward_to_console="
|
||||
|
||||
@ -19,9 +19,9 @@
|
||||
<a href="systemd.directives.html">Directives </a>·
|
||||
<a href="../python-systemd/index.html">Python </a>·
|
||||
<a href="../libudev/index.html">libudev </a>·
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 215</span><hr><div class="refentry"><a name="journald.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>journald.conf — Journal service configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/journald.conf</code></p></div><div class="refsect1"><a name="idm214198630544"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>This file configures various parameters of the
|
||||
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 217</span><hr><div class="refentry"><a name="journald.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>journald.conf — Journal service configuration file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/journald.conf</code></p></div><div class="refsect1"><a name="idm214196102640"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>This file configures various parameters of the
|
||||
systemd journal service,
|
||||
<a href="systemd-journald.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>.</p></div><div class="refsect1"><a name="idm214200500944"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>All options are configured in the
|
||||
<a href="systemd-journald.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>.</p></div><div class="refsect1"><a name="idm214196100464"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>All options are configured in the
|
||||
"<code class="literal">[Journal]</code>" section:</p><div class="variablelist"><dl class="variablelist"><dt id="Storage="><span class="term"><code class="varname">Storage=</code></span><a class="headerlink" title="Permalink to this term" href="#Storage=">¶</a></dt><dd><p>Controls where to
|
||||
store journal data. One of
|
||||
"<code class="literal">volatile</code>",
|
||||
@ -275,8 +275,8 @@
|
||||
forwarding to syslog is enabled but no
|
||||
syslog daemon is running, the
|
||||
respective option has no effect. By
|
||||
default, only forwarding to syslog and
|
||||
wall is enabled. These settings may be
|
||||
default, only forwarding wall is
|
||||
enabled. These settings may be
|
||||
overridden at boot time with the
|
||||
kernel command line options
|
||||
"<code class="literal">systemd.journald.forward_to_syslog=</code>",
|
||||
@ -285,9 +285,9 @@
|
||||
and
|
||||
"<code class="literal">systemd.journald.forward_to_wall=</code>".
|
||||
When forwarding to the console, the
|
||||
TTY to log to can be changed
|
||||
with <code class="varname">TTYPath=</code>,
|
||||
described below.</p></dd><dt id="MaxLevelStore="><span class="term"><code class="varname">MaxLevelStore=</code>, </span><span class="term"><code class="varname">MaxLevelSyslog=</code>, </span><span class="term"><code class="varname">MaxLevelKMsg=</code>, </span><span class="term"><code class="varname">MaxLevelConsole=</code>, </span><span class="term"><code class="varname">MaxLevelWall=</code></span><a class="headerlink" title="Permalink to this term" href="#MaxLevelStore=">¶</a></dt><dd><p>Controls the maximum
|
||||
TTY to log to can be changed with
|
||||
<code class="varname">TTYPath=</code>, described
|
||||
below.</p></dd><dt id="MaxLevelStore="><span class="term"><code class="varname">MaxLevelStore=</code>, </span><span class="term"><code class="varname">MaxLevelSyslog=</code>, </span><span class="term"><code class="varname">MaxLevelKMsg=</code>, </span><span class="term"><code class="varname">MaxLevelConsole=</code>, </span><span class="term"><code class="varname">MaxLevelWall=</code></span><a class="headerlink" title="Permalink to this term" href="#MaxLevelStore=">¶</a></dt><dd><p>Controls the maximum
|
||||
log level of messages that are stored
|
||||
on disk, forwarded to syslog, kmsg,
|
||||
the console or wall (if that is
|
||||
@ -321,7 +321,7 @@
|
||||
to use if
|
||||
<code class="varname">ForwardToConsole=yes</code>
|
||||
is used. Defaults to
|
||||
<code class="filename">/dev/console</code>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214200261392"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<code class="filename">/dev/console</code>.</p></dd></dl></div></div><div class="refsect1"><a name="idm214194981616"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
||||
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
|
||||
<a href="systemd-journald.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>,
|
||||
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
|
||||
|
||||
@ -395,8 +395,8 @@
|
||||
forwarding to syslog is enabled but no
|
||||
syslog daemon is running, the
|
||||
respective option has no effect. By
|
||||
default, only forwarding to syslog and
|
||||
wall is enabled. These settings may be
|
||||
default, only forwarding wall is
|
||||
enabled. These settings may be
|
||||
overridden at boot time with the
|
||||
kernel command line options
|
||||
<literal>systemd.journald.forward_to_syslog=</literal>,
|
||||
@ -405,9 +405,9 @@
|
||||
and
|
||||
<literal>systemd.journald.forward_to_wall=</literal>.
|
||||
When forwarding to the console, the
|
||||
TTY to log to can be changed
|
||||
with <varname>TTYPath=</varname>,
|
||||
described below.</para></listitem>
|
||||
TTY to log to can be changed with
|
||||
<varname>TTYPath=</varname>, described
|
||||
below.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
'\" t
|
||||
.TH "KERNEL\-COMMAND\-LINE" "7" "" "systemd 215" "kernel-command-line"
|
||||
.TH "KERNEL\-COMMAND\-LINE" "7" "" "systemd 217" "kernel-command-line"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
@ -69,7 +69,7 @@ Parameter understood by both the kernel and the system and service manager to co
|
||||
\fBsystemd\fR(1)\&.
|
||||
.RE
|
||||
.PP
|
||||
\fI\-b\fR, \fIemergency\fR, \fIsingle\fR, \fIs\fR, \fIS\fR, \fI1\fR, \fI2\fR, \fI3\fR, \fI4\fR, \fI5\fR
|
||||
\fI\-b\fR, \fIemergency\fR, \fIrescue\fR, \fIsingle\fR, \fIs\fR, \fIS\fR, \fI1\fR, \fI2\fR, \fI3\fR, \fI4\fR, \fI5\fR
|
||||
.RS 4
|
||||
Parameters understood by the system and service manager, as compatibility options\&. For details, see
|
||||
\fBsystemd\fR(1)\&.
|
||||
@ -105,7 +105,7 @@ Parameters understood by the virtual console setup logic\&. For details, see
|
||||
\fBsystemd-vconsole-setup.service\fR(8)\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIudev\&.log\-priority=\fR, \fIrd\&.udev\&.log\-priority=\fR, \fIudev\&.children\-max=\fR, \fIrd\&.udev\&.children\-max=\fR, \fIudev\&.exec\-delay=\fR, \fIrd\&.udev\&.exec\-delay=\fR, \fInet\&.ifnames=\fR
|
||||
\fIudev\&.log\-priority=\fR, \fIrd\&.udev\&.log\-priority=\fR, \fIudev\&.children\-max=\fR, \fIrd\&.udev\&.children\-max=\fR, \fIudev\&.exec\-delay=\fR, \fIrd\&.udev\&.exec\-delay=\fR, \fIudev\&.event\-timeout=\fR, \fIrd\&.udev\&.event\-timeout=\fR, \fInet\&.ifnames=\fR
|
||||
.RS 4
|
||||
Parameters understood by the device event managing daemon\&. For details, see
|
||||
\fBsystemd-udevd.service\fR(8)\&.
|
||||
@ -148,6 +148,13 @@ Configures whether GPT based partition auto\-discovery shall be attempted\&. For
|
||||
Load a specific kernel module early at boot\&. For details, see
|
||||
\fBsystemd-modules-load.service\fR(8)\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIresume=\fR
|
||||
.RS 4
|
||||
Enables resume from hibernation using the specified device\&. All
|
||||
\fBfstab\fR(5)\-like paths are supported\&. For details, see
|
||||
\fBsystemd-hibernate-resume-generator\fR(8)\&.
|
||||
.RE
|
||||
.SH "SEE ALSO"
|
||||
.PP
|
||||
\fBsystemd\fR(1),
|
||||
@ -165,7 +172,8 @@ Load a specific kernel module early at boot\&. For details, see
|
||||
\fBsystemd-gpt-auto-generator\fR(8),
|
||||
\fBsystemd-modules-load.service\fR(8),
|
||||
\fBsystemd-backlight@.service\fR(8),
|
||||
\fBsystemd-rfkill@.service\fR(8)
|
||||
\fBsystemd-rfkill@.service\fR(8),
|
||||
\fBsystemd-hibernate-resume-generator\fR(8)
|
||||
.SH "NOTES"
|
||||
.IP " 1." 4
|
||||
kernel-parameters.txt
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user