← Back to branch summary

~ubuntu-branches/debian/jessie/systemd/jessie

« back to all changes in this revision

Viewing changes to man/systemctl.xml

  • Committer: Package Import Robot
  • Author(s): Tollef Fog Heen, Tollef Fog Heen, Michael Biebl
  • Date: 2012-04-03 19:59:17 UTC
  • mfrom: (1.1.10) (6.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20120403195917-l532urrbg4pkreas
Tags: 44-1
http://bugs.debian.org/664364
http://bugs.debian.org/663219
http://bugs.debian.org/663323
[ Tollef Fog Heen ]
* New upstream version.
  - Backport 3492207: journal: PAGE_SIZE is not known on ppc and other
    archs
  - Backport 5a2a2a1: journal: react with immediate rotation to a couple
    of more errors
  - Backport 693ce21: util: never follow symlinks in rm_rf_children()
    Fixes CVE-2012-1174, closes: #664364
* Drop output message from init-functions hook, it's pointless.
* Only rmdir /lib/init/rw if it exists.
* Explicitly order debian-fixup before sysinit.target to prevent a
  possible race condition with the creation of sockets.  Thanks to
  Michael Biebl for debugging this.
* Always restart the initctl socket on upgrades, to mask sysvinit
  removing it.

[ Michael Biebl ]
* Remove workaround for non-interactive sessions from pam config again.
* Create compat /dev/initctl symlink in case we are upgrading from a system
  running a newer version of sysvinit (using /run/initctl) and sysvinit is
  replaced with systemd-sysv during the upgrade. Closes: #663219
* Install new man pages.
* Build-Depend on valac (>= 0.12) instead of valac-0.12. Closes: #663323

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/systemctl.xml
349
349
                                <command>halt</command>,
350
350
                                <command>poweroff</command>,
351
351
                                <command>reboot</command> or
352
 
                                <command>kexec</command> execute
 
352
                                <command>kexec</command> execute the
353
353
                                selected operation without shutting
354
354
                                down all units. However, all processes
355
355
                                will be killed forcibly and all file
356
356
                                systems are unmounted or remounted
357
357
                                read-only. This is hence a drastic but
358
358
                                relatively safe option to request an
359
 
                                immediate reboot.</para></listitem>
 
359
                                immediate reboot. If
 
360
                                <option>--force</option> is specified
 
361
                                twice for these operations, they will
 
362
                                be executed immediately without
 
363
                                terminating any processes or umounting
 
364
                                any file systems. Warning: specifying
 
365
                                <option>--force</option> twice with
 
366
                                any of these operations might result
 
367
                                in data loss.</para></listitem>
360
368
                        </varlistentry>
361
369
 
362
370
                        <varlistentry>
406
414
                                PolicyKit before executing the
407
415
                                operation.</para></listitem>
408
416
                        </varlistentry>
 
417
 
 
418
                        <varlistentry>
 
419
                                <term><option>--lines=</option></term>
 
420
                                <term><option>-n</option></term>
 
421
 
 
422
                                <listitem><para>When used with
 
423
                                <command>status</command> controls the
 
424
                                number of journal lines to show,
 
425
                                counting from the most recent
 
426
                                ones. Takes a positive integer
 
427
                                argument. Defaults to
 
428
                                10.</para></listitem>
 
429
                        </varlistentry>
 
430
 
 
431
                        <varlistentry>
 
432
                                <term><option>--follow</option></term>
 
433
                                <term><option>-f</option></term>
 
434
 
 
435
                                <listitem><para>When used with
 
436
                                <command>status</command> continously
 
437
                                prints new journal entries as they are
 
438
                                appended to the
 
439
                                journal.</para></listitem>
 
440
                        </varlistentry>
 
441
 
 
442
                        <varlistentry>
 
443
                                <term><option>--output=</option></term>
 
444
                                <term><option>-o</option></term>
 
445
 
 
446
                                <listitem><para>When used with
 
447
                                <command>status</command> controls the
 
448
                                formatting of the journal entries that
 
449
                                are shown. For the available choices
 
450
                                see
 
451
                                <citerefentry><refentrytitle>systemd-journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>. Defaults
 
452
                                to
 
453
                                <literal>short</literal>.</para></listitem>
 
454
                        </varlistentry>
 
455
 
409
456
                </variablelist>
410
457
 
411
458
                <para>The following commands are understood:</para>
550
597
 
551
598
                                <listitem><para>Show terse runtime
552
599
                                status information about one or more
553
 
                                units. This function is intended to
554
 
                                generate human-readable output. If you
555
 
                                are looking for computer-parsable
556
 
                                output, use <command>show</command>
557
 
                                instead. If a PID is passed
558
 
                                information about the unit the process
559
 
                                of the PID belongs to is
560
 
                                shown.</para></listitem>
 
600
                                units, followed by its most recent log
 
601
                                data from the journal. This function
 
602
                                is intended to generate human-readable
 
603
                                output. If you are looking for
 
604
                                computer-parsable output, use
 
605
                                <command>show</command> instead. If a
 
606
                                PID is passed information about the
 
607
                                unit the process of the PID belongs to
 
608
                                is shown.</para></listitem>
561
609
                        </varlistentry>
562
610
                        <varlistentry>
563
611
                                <term><command>show [NAME...|JOB...]</command></term>
1017
1065
                                system. This is mostly equivalent to
1018
1066
                                <command>start halt.target</command>
1019
1067
                                but also prints a wall message to all
1020
 
                                users.  If
1021
 
                                combined with <option>--force</option>
1022
 
                                shutdown of all running services is
1023
 
                                skipped, however all processes are killed
1024
 
                                and all file systems are unmounted or
 
1068
                                users.  If combined with
 
1069
                                <option>--force</option> shutdown of
 
1070
                                all running services is skipped,
 
1071
                                however all processes are killed and
 
1072
                                all file systems are unmounted or
1025
1073
                                mounted read-only, immediately
1026
 
                                followed by the
1027
 
                                system halt.</para></listitem>
 
1074
                                followed by the system halt.  If
 
1075
                                <option>--force</option> is specified
 
1076
                                twice the the operation is immediately
 
1077
                                executed without terminating any
 
1078
                                processes or unmounting any file
 
1079
                                systems. This may result in data
 
1080
                                loss.</para></listitem>
1028
1081
                        </varlistentry>
1029
1082
                        <varlistentry>
1030
1083
                                <term><command>poweroff</command></term>
1033
1086
                                power-off the system. This is mostly
1034
1087
                                equivalent to <command>start
1035
1088
                                poweroff.target</command> but also
1036
 
                                prints a wall message to all
1037
 
                                users. If
 
1089
                                prints a wall message to all users. If
1038
1090
                                combined with <option>--force</option>
1039
1091
                                shutdown of all running services is
1040
 
                                skipped, however all processes are killed
1041
 
                                and all file systems are unmounted or
1042
 
                                mounted read-only, immediately
1043
 
                                followed by the
1044
 
                                powering off.</para></listitem>
 
1092
                                skipped, however all processes are
 
1093
                                killed and all file systems are
 
1094
                                unmounted or mounted read-only,
 
1095
                                immediately followed by the powering
 
1096
                                off. If <option>--force</option> is
 
1097
                                specified twice the the operation is
 
1098
                                immediately executed without
 
1099
                                terminating any processes or
 
1100
                                unmounting any file systems. This may
 
1101
                                result in data loss.</para></listitem>
1045
1102
                        </varlistentry>
1046
1103
                        <varlistentry>
1047
1104
                                <term><command>reboot</command></term>
1048
1105
 
1049
 
                                <listitem><para>Shut down and
1050
 
                                reboot the system. This is mostly
1051
 
                                equivalent to <command>start
 
1106
                                <listitem><para>Shut down and reboot
 
1107
                                the system. This is mostly equivalent
 
1108
                                to <command>start
1052
1109
                                reboot.target</command> but also
1053
 
                                prints a wall message to all
1054
 
                                users. If
 
1110
                                prints a wall message to all users. If
1055
1111
                                combined with <option>--force</option>
1056
1112
                                shutdown of all running services is
1057
 
                                skipped, however all processes are killed
1058
 
                                and all file systems are unmounted or
1059
 
                                mounted read-only, immediately
1060
 
                                followed by the
1061
 
                                reboot.</para></listitem>
 
1113
                                skipped, however all processes are
 
1114
                                killed and all file systems are
 
1115
                                unmounted or mounted read-only,
 
1116
                                immediately followed by the reboot. If
 
1117
                                <option>--force</option> is specified
 
1118
                                twice the the operation is immediately
 
1119
                                executed without terminating any
 
1120
                                processes or unmounting any file
 
1121
                                systems. This may result in data
 
1122
                                loss.</para></listitem>
1062
1123
                        </varlistentry>
1063
1124
                        <varlistentry>
1064
1125
                                <term><command>kexec</command></term>
1118
1179
                <para>
1119
1180
                        <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
1120
1181
                        <citerefentry><refentrytitle>systemadm</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 
1182
                        <citerefentry><refentrytitle>systemd-journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
1121
1183
                        <citerefentry><refentrytitle>systemd-loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
1122
1184
                        <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
1123
1185
                        <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,