man/systemctl.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3         "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   This file is part of systemd.
   7
   8   Copyright 2010 Lennart Poettering
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU General Public License as published by
  12   the Free Software Foundation; either version 2 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   General Public License for more details.
  19
  20   You should have received a copy of the GNU General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 -->
  23
  24 <refentry id="systemctl">
  25
  26         <refentryinfo>
  27                 <title>systemctl</title>
  28                 <productname>systemd</productname>
  29
  30                 <authorgroup>
  31                         <author>
  32                                 <contrib>Developer</contrib>
  33                                 <firstname>Lennart</firstname>
  34                                 <surname>Poettering</surname>
  35                                 <email>lennart@poettering.net</email>
  36                         </author>
  37                 </authorgroup>
  38         </refentryinfo>
  39
  40         <refmeta>
  41                 <refentrytitle>systemctl</refentrytitle>
  42                 <manvolnum>1</manvolnum>
  43         </refmeta>
  44
  45         <refnamediv>
  46                 <refname>systemctl</refname>
  47                 <refpurpose>Control the systemd system and session manager</refpurpose>
  48         </refnamediv>
  49
  50         <refsynopsisdiv>
  51                 <cmdsynopsis>
  52                         <command>systemctl <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg> <arg choice="opt" rep="repeat">NAME</arg></command>
  53                 </cmdsynopsis>
  54         </refsynopsisdiv>
  55
  56         <refsect1>
  57                 <title>Description</title>
  58
  59                 <para><command>systemctl</command> may be used to
  60                 introspect and control the state of the
  61                 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  62                 system and session manager.</para>
  63         </refsect1>
  64
  65         <refsect1>
  66                 <title>Options</title>
  67
  68                 <para>The following options are understood:</para>
  69
  70                 <variablelist>
  71                         <varlistentry>
  72                                 <term><option>--help</option></term>
  73                                 <term><option>-h</option></term>
  74
  75                                 <listitem><para>Prints a short help
  76                                 text and exits.</para></listitem>
  77                         </varlistentry>
  78
  79                         <varlistentry>
  80                                 <term><option>--type=</option></term>
  81                                 <term><option>-t</option></term>
  82
  83                                 <listitem><para>When listing units,
  84                                 limit display to certain unit
  85                                 types. If not specified units of all
  86                                 types will be shown. The argument
  87                                 should be a unit type name such as
  88                                 <option>service</option>,
  89                                 <option>socket</option> and
  90                                 similar.</para></listitem>
  91                         </varlistentry>
  92
  93                         <varlistentry>
  94                                 <term><option>--property=</option></term>
  95                                 <term><option>-p</option></term>
  96
  97                                 <listitem><para>When showing
  98                                 unit/job/manager information, limit
  99                                 display to certain properties as
 100                                 specified as argument. If not
 101                                 specified all set properties are
 102                                 shown. The argument should be a
 103                                 property name, such as
 104                                 <literal>MainPID</literal>. If
 105                                 specified more than once all
 106                                 properties with the specified names
 107                                 are shown.</para></listitem>
 108                         </varlistentry>
 109
 110                         <varlistentry>
 111                                 <term><option>--all</option></term>
 112                                 <term><option>-a</option></term>
 113
 114                                 <listitem><para>When listing units,
 115                                 show all units, regardless of their
 116                                 state, including inactive units. When
 117                                 showing unit/job/manager information,
 118                                 show all properties regardless whether
 119                                 they are set or not.</para></listitem>
 120                         </varlistentry>
 121
 122                         <varlistentry>
 123                                 <term><option>--full</option></term>
 124
 125                                 <listitem><para>Do not ellipsize unit
 126                                 names in the output of
 127                                 <command>list-units</command> and
 128                                 <command>list-jobs</command>.</para></listitem>
 129                         </varlistentry>
 130
 131                         <varlistentry>
 132                                 <term><option>--fail</option></term>
 133
 134                                 <listitem><para>If the requested
 135                                 operation conflicts with a pending
 136                                 unfinished job, fail the command. If
 137                                 this is not specified the requested
 138                                 operation will replace the pending job,
 139                                 if necessary.</para></listitem>
 140                         </varlistentry>
 141
 142                         <varlistentry>
 143                                 <term><option>--quiet</option></term>
 144                                 <term><option>-q</option></term>
 145
 146                                 <listitem><para>Suppress output to
 147                                 STDOUT in
 148                                 <command>snapshot</command>,
 149                                 <command>check</command>,
 150                                 <command>enable</command> and
 151                                 <command>disable</command>.</para></listitem>
 152                         </varlistentry>
 153
 154                         <varlistentry>
 155                                 <term><option>--no-block</option></term>
 156
 157                                 <listitem><para>Do not synchronously wait for
 158                                 the requested operation to finish. If this is
 159                                 not specified the job will be verified,
 160                                 enqueued and <command>systemctl</command> will
 161                                 wait until it is completed. By passing this
 162                                 argument it is only verified and
 163                                 enqueued.</para></listitem> </varlistentry>
 164
 165                         <varlistentry>
 166                                 <term><option>--system</option></term>
 167
 168                                 <listitem><para>Talk to the systemd
 169                                 system manager. (Default)</para></listitem>
 170                         </varlistentry>
 171
 172                         <varlistentry>
 173                                 <term><option>--session</option></term>
 174
 175                                 <listitem><para>Talk to the systemd
 176                                 session manager of the calling user.</para></listitem>
 177                         </varlistentry>
 178
 179                         <varlistentry>
 180                                 <term><option>--order</option></term>
 181                                 <term><option>--require</option></term>
 182
 183                                 <listitem><para>When used in
 184                                 conjunction with the
 185                                 <command>dot</command> command (see
 186                                 below), selects which dependencies are
 187                                 shown in the dependency graph. If
 188                                 <option>--order</option> is passed
 189                                 only dependencies of type
 190                                 <varname>After=</varname> or
 191                                 <varname>Before=</varname> are
 192                                 shown. If <option>--require</option>
 193                                 is passed only dependencies of type
 194                                 <varname>Requires=</varname>,
 195                                 <varname>RequiresOverridable=</varname>,
 196                                 <varname>Requisite=</varname>,
 197                                 <varname>RequisiteOverridable=</varname>,
 198                                 <varname>Wants=</varname> and
 199                                 <varname>Conflicts=</varname> are
 200                                 shown. If neither is passed, shows
 201                                 dependencies of all these
 202                                 types.</para></listitem>
 203                         </varlistentry>
 204
 205                         <varlistentry>
 206                                 <term><option>--no-wall</option></term>
 207
 208                                 <listitem><para>Don't send wall
 209                                 message before
 210                                 halt, power-off, reboot.</para></listitem>
 211                         </varlistentry>
 212
 213                         <varlistentry>
 214                                 <term><option>--global</option></term>
 215
 216                                 <listitem><para>When used with
 217                                 <command>enable</command> and
 218                                 <command>disable</command>, operate on the
 219                                 global session configuŕation
 220                                 directory, thus enabling or disabling
 221                                 a unit file globally for all future
 222                                 sessions of all users.</para></listitem>
 223                         </varlistentry>
 224
 225                         <varlistentry>
 226                                 <term><option>--no-reload</option></term>
 227
 228                                 <listitem><para>When used with
 229                                 <command>enable</command> and
 230                                 <command>disable</command>, do not
 231                                 implicitly reload daemon configuration
 232                                 after executing the
 233                                 changes.</para></listitem>
 234                         </varlistentry>
 235
 236                         <varlistentry>
 237                                 <term><option>--force</option></term>
 238
 239                                 <listitem><para>When used with
 240                                 <command>enable</command>, override any
 241                                 existing conflicting
 242                                 symlinks.</para></listitem>
 243                         </varlistentry>
 244
 245                         <varlistentry>
 246                                 <term><option>--defaults</option></term>
 247
 248                                 <listitem><para>When used with
 249                                 <command>disable</command>, ensures
 250                                 that only the symlinks created by
 251                                 <command>enable</command> are removed,
 252                                 not all symlinks pointing to the unit
 253                                 file that shall be
 254                                 disabled.</para></listitem>
 255                         </varlistentry>
 256                 </variablelist>
 257
 258                 <para>The following commands are understood:</para>
 259
 260                 <variablelist>
 261                         <varlistentry>
 262                                 <term><command>list-units</command></term>
 263
 264                                 <listitem><para>List known units.</para></listitem>
 265                         </varlistentry>
 266                         <varlistentry>
 267                                 <term><command>start [NAME...]</command></term>
 268
 269                                 <listitem><para>Start (activate) one
 270                                 or more units specified on the command
 271                                 line.</para></listitem>
 272                         </varlistentry>
 273                         <varlistentry>
 274                                 <term><command>stop [NAME...]</command></term>
 275
 276                                 <listitem><para>Stop (deactivate) one
 277                                 or more units specified on the command
 278                                 line.</para></listitem>
 279                         </varlistentry>
 280                         <varlistentry>
 281                                 <term><command>reload [NAME...]</command></term>
 282
 283                                 <listitem><para>Asks all units listed
 284                                 on the command line to reload their
 285                                 configuration. Note that this will
 286                                 reload the service-specific
 287                                 configuration, not the unit
 288                                 configuration file of systemd. If you
 289                                 want systemd to reload the
 290                                 configuration file of a unit use the
 291                                 <command>daemon-reload</command>
 292                                 command. In other words: for the
 293                                 example case of Apache, this will
 294                                 reload Apache's
 295                                 <filename>httpd.conf</filename> in the
 296                                 web server, not the
 297                                 <filename>apache.service</filename>
 298                                 systemd unit file. </para>
 299
 300                                 <para>This command should not be
 301                                 confused with the
 302                                 <command>daemon-reload</command> or
 303                                 <command>load</command>
 304                                 commands.</para></listitem>
 305
 306                         </varlistentry>
 307                         <varlistentry>
 308                                 <term><command>restart [NAME...]</command></term>
 309
 310                                 <listitem><para>Restart one or more
 311                                 units specified on the command
 312                                 line. If the units are not running yet
 313                                 they will be
 314                                 started.</para></listitem>
 315                         </varlistentry>
 316                         <varlistentry>
 317                                 <term><command>try-restart [NAME...]</command></term>
 318
 319                                 <listitem><para>Restart one or more
 320                                 units specified on the command
 321                                 line. If the units are not running yet
 322                                 the operation will
 323                                 fail.</para></listitem>
 324                         </varlistentry>
 325                         <varlistentry>
 326                                 <term><command>reload-or-restart [NAME...]</command></term>
 327                                 <term><command>reload-or-try-restart [NAME...]</command></term>
 328
 329                                 <listitem><para>Reload one or more
 330                                 units if they support it. If not,
 331                                 restart them instead. Note that for
 332                                 compatibility with SysV and Red Hat
 333                                 init scripts
 334                                 <command>force-reload</command> and
 335                                 <command>condrestart</command> may be
 336                                 used as equivalent commands to
 337                                 <command>reload-or-try-restart</command>.</para></listitem>
 338                         </varlistentry>
 339                         <varlistentry>
 340                                 <term><command>isolate [NAME]</command></term>
 341
 342                                 <listitem><para>Start the unit
 343                                 specified on the command line and its
 344                                 dependencies and stop all others. Note
 345                                 that this works only on units where
 346                                 <option>AllowIsolate=</option> is
 347                                 enabled. See
 348                                 <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 349                                 for details.</para></listitem>
 350                         </varlistentry>
 351                         <varlistentry>
 352                                 <term><command>is-active [NAME...]</command></term>
 353
 354                                 <listitem><para>Check whether any of
 355                                 the specified units is active
 356                                 (i.e. running). Returns an exit code
 357                                 0 if at least one is active, non-zero
 358                                 otherwise. Unless
 359                                 <option>--quiet</option> is specified
 360                                 this will also print the current unit
 361                                 state to STDOUT.</para></listitem>
 362                         </varlistentry>
 363                         <varlistentry>
 364                                 <term><command>status [NAME...|PID...]</command></term>
 365
 366                                 <listitem><para>Show terse runtime
 367                                 status information about one or more
 368                                 units. This function is intended to
 369                                 generate human-readable output. If you
 370                                 are looking for computer-parsable
 371                                 output, use <command>show</command>
 372                                 instead. If a PID is passed
 373                                 information about the unit the process
 374                                 of the PID belongs to is
 375                                 shown.</para></listitem>
 376                         </varlistentry>
 377                         <varlistentry>
 378                                 <term><command>show [NAME...|JOB...]</command></term>
 379
 380                                 <listitem><para>Show properties of one
 381                                 or more units, jobs or the manager
 382                                 itself. If no argument is specified
 383                                 properties of the manager will be
 384                                 shown. If a unit name is specified
 385                                 properties of the unit is shown, and
 386                                 if a job id is specified properties of
 387                                 the job is shown. By default, empty
 388                                 properties are suppressed. Use
 389                                 <option>--all</option> to show those
 390                                 too. To select specific properties to
 391                                 show use
 392                                 <option>--property=</option>. This
 393                                 command is intended to be used
 394                                 whenever computer-parsable output is
 395                                 required. Use
 396                                 <command>status</command> if you are
 397                                 looking for formatted human-readable
 398                                 output.</para></listitem>
 399                         </varlistentry>
 400
 401                         <varlistentry>
 402                                 <term><command>reset-failed [NAME...]</command></term>
 403
 404                                 <listitem><para>Reset the
 405                                 '<literal>failed</literal>' state of the
 406                                 specified units, or if no unit name is
 407                                 passed of all units. When a unit fails
 408                                 in some way (i.e. process exiting with
 409                                 non-zero error code, terminating
 410                                 abnormally or timing out) it will
 411                                 automatically enter the
 412                                 '<literal>failed</literal>' state and
 413                                 its exit code and status is recorded
 414                                 for introspection by the administrator
 415                                 until the service is restarted or
 416                                 reset with this
 417                                 command.</para></listitem>
 418                         </varlistentry>
 419
 420                         <varlistentry>
 421                                 <term><command>enable [NAME...]</command></term>
 422
 423                                 <listitem><para>Enable one or more
 424                                 unit files, as specified on the
 425                                 command line. This will create a
 426                                 number of symlinks as encoded in the
 427                                 <literal>[Install]</literal> sections
 428                                 of the unit files. After the symlinks
 429                                 have been created the systemd
 430                                 configuration is reloaded (in a way
 431                                 that is equivalent to
 432                                 <command>daemon-reload</command>) to
 433                                 ensure the changes are taken into
 434                                 account immediately. Note that this
 435                                 does not have the effect that any of
 436                                 the units enabled are also started at
 437                                 the same time. If this is desired a
 438                                 seperate <command>start</command>
 439                                 command must be invoked for the
 440                                 unit.</para>
 441
 442                                 <para>This command will
 443                                 print the actions executed. This
 444                                 output may be suppressed by passing
 445                                 <option>--quiet</option>.</para>
 446
 447                                 <para>Note that this operation creates
 448                                 only the suggested symlinks for the
 449                                 units. While this command is the
 450                                 recommended way to manipulate the unit
 451                                 configuration directory, the
 452                                 administrator is free to make
 453                                 additional changes manually, by
 454                                 placing or removing symlinks in the
 455                                 directory. This is particular useful
 456                                 to create configurations that deviate
 457                                 from the suggested default
 458                                 installation. In this case the
 459                                 administrator must make sure to invoke
 460                                 <command>daemon-reload</command>
 461                                 manually as necessary, to ensure his
 462                                 changes are taken into account.</para>
 463
 464                                 <para>Enabling units should not be
 465                                 confused with starting (activating)
 466                                 units, as done by the
 467                                 <command>start</command>
 468                                 command. Enabling and starting units
 469                                 is orthogonal: units may be enabled
 470                                 without being started and started
 471                                 without being enabled. Enabling simply
 472                                 hooks the unit into various suggested
 473                                 places (for example, so that the unit
 474                                 is automatically started on boot or
 475                                 when a particular kind of hardware is
 476                                 plugged in). Starting actually spawns
 477                                 the daemon process (in case of service
 478                                 units), or binds the socket (in case
 479                                 of socket units), and so
 480                                 on.</para>
 481
 482                                 <para>Depending on whether
 483                                 <option>--system</option>,
 484                                 <option>--session</option> or
 485                                 <option>--global</option> is specified
 486                                 this enables the unit for the system,
 487                                 for sessions of the calling user only
 488                                 or for all future session of all
 489                                 users. Note that in the latter case no
 490                                 systemd daemon configuration is
 491                                 reloaded.</para>
 492                                 </listitem>
 493                         </varlistentry>
 494
 495                         <varlistentry>
 496                                 <term><command>disable [NAME...]</command></term>
 497
 498                                 <listitem><para>Disables one or more
 499                                 units. This removes all symlinks to
 500                                 the specified unit files from the unit
 501                                 configuration directory, and hence
 502                                 undoes the changes made by
 503                                 <command>enable</command>. Note
 504                                 however that this by default removes
 505                                 all symlinks to the unit files
 506                                 (i.e. including manual additions), not
 507                                 just those actually created by
 508                                 <command>enable</command>. If only the
 509                                 symlinks that are suggested by default
 510                                 shall be removed, pass
 511                                 <option>--defaults</option>. This
 512                                 implicitly reloads the systemd daemon
 513                                 configuration after completing the
 514                                 disabling of the units. Note that this
 515                                 command does not implicitly stop the
 516                                 units that is being disabled. If this
 517                                 is desired an additional
 518                                 <command>stop</command>command should
 519                                 be executed afterwards.</para>
 520
 521                                 <para>This command will print the
 522                                 actions executed. This output may be
 523                                 suppressed by passing
 524                                 <option>--quiet</option>.</para>
 525                                 </listitem>
 526
 527                                 <para>This command honours
 528                                 <option>--system</option>,
 529                                 <option>--session</option>,
 530                                 <option>--global</option> in a similar
 531                                 way as
 532                                 <command>enable</command>.</para>
 533                         </varlistentry>
 534
 535                         <varlistentry>
 536                                 <term><command>is-enabled [NAME...]</command></term>
 537
 538                                 <listitem><para>Checks whether any of
 539                                 the specified unit files is enabled
 540                                 (as with
 541                                 <command>enable</command>). Returns an
 542                                 exit code of 0 if at least one is
 543                                 enabled, non-zero
 544                                 otherwise.</para></listitem>
 545                         </varlistentry>
 546
 547                         <varlistentry>
 548                                 <term><command>load [NAME...]</command></term>
 549
 550                                 <listitem><para>Load one or more units
 551                                 specified on the command line. This
 552                                 will simply load their configuration
 553                                 from disk, but not start them. To
 554                                 start them you need to use the
 555                                 <command>start</command> command which
 556                                 will implicitly load a unit that has
 557                                 not been loaded yet. Note that systemd
 558                                 garbage collects loaded units that are
 559                                 not active or referenced by an active
 560                                 unit. This means that units loaded
 561                                 this way will usually not stay loaded
 562                                 for long. Also note that this command
 563                                 cannot be used to reload unit
 564                                 configuration. Use the
 565                                 <command>daemon-reload</command>
 566                                 command for that. All in all, this
 567                                 command is of little use except for
 568                                 debugging.</para>
 569                                 <para>This command should not be
 570                                 confused with the
 571                                 <command>daemon-reload</command> or
 572                                 <command>reload</command>
 573                                 commands.</para></listitem>
 574                         </varlistentry>
 575                         <varlistentry>
 576                                 <term><command>list-jobs</command></term>
 577
 578                                 <listitem><para>List jobs that are in progress.</para></listitem>
 579                         </varlistentry>
 580                         <varlistentry>
 581                                 <term><command>cancel [JOB...]</command></term>
 582
 583                                 <listitem><para>Cancel one or more
 584                                 jobs specified on the command line by
 585                                 their numeric job
 586                                 IDs. If not job id is specified cancels all jobs that are pending.</para></listitem>
 587                         </varlistentry>
 588                         <varlistentry>
 589                                 <term><command>monitor</command></term>
 590
 591                                 <listitem><para>Monitor unit/job
 592                                 changes. This is mostly useful for
 593                                 debugging purposes and prints a line
 594                                 each time systemd loads or unloads a
 595                                 unit configuration file, or a unit
 596                                 property changes.</para></listitem>
 597                         </varlistentry>
 598                         <varlistentry>
 599                                 <term><command>dump</command></term>
 600
 601                                 <listitem><para>Dump server
 602                                 status. This will output a (usually
 603                                 very long) human readable manager
 604                                 status dump. Its format is subject to
 605                                 change without notice and should not
 606                                 be parsed by
 607                                 applications.</para></listitem>
 608                         </varlistentry>
 609                         <varlistentry>
 610                                 <term><command>dot</command></term>
 611
 612                                 <listitem><para>Generate textual
 613                                 dependency graph description in dot
 614                                 format for further processing with the
 615                                 GraphViz
 616                                 <citerefentry><refentrytitle>dot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 617                                 tool. Use a command line like
 618                                 <command>systemctl dot | dot -Tsvg >
 619                                 systemd.svg</command> to generate a
 620                                 graphical dependency tree. Unless
 621                                 <option>--order</option> or
 622                                 <option>--require</option> is passed
 623                                 the generated graph will show both
 624                                 ordering and requirement
 625                                 dependencies.</para></listitem>
 626                         </varlistentry>
 627                         <varlistentry>
 628                                 <term><command>snapshot [NAME]</command></term>
 629
 630                                 <listitem><para>Create a snapshot. If
 631                                 a snapshot name is specified, the new
 632                                 snapshot will be named after it. If
 633                                 none is specified an automatic
 634                                 snapshot name is generated. In either
 635                                 case, the snapshot name used is
 636                                 printed to STDOUT, unless
 637                                 <option>--quiet</option> is
 638                                 specified.</para>
 639
 640                                 <para>A snapshot refers to a saved
 641                                 state of the systemd manager. It is
 642                                 implemented itself as unit that is
 643                                 generated dynamically with this
 644                                 command and has dependencies on all
 645                                 units active at the time. At a later
 646                                 time the user may return to this state
 647                                 by using the
 648                                 <command>isolate</command> command on
 649                                 the snapshot unit.</para></listitem>
 650
 651                                 <para>Snapshots are only useful for
 652                                 saving and restoring which units are
 653                                 running or are stopped, they do not
 654                                 save/restore any other
 655                                 state. Snapshots are dynamic and lost
 656                                 on reboot.</para>
 657                         </varlistentry>
 658                         <varlistentry>
 659                                 <term><command>delete [NAME...]</command></term>
 660
 661                                 <listitem><para>Remove a snapshot
 662                                 previously created with
 663                                 <command>snapshot</command>.</para></listitem>
 664                         </varlistentry>
 665                         <varlistentry>
 666                                 <term><command>daemon-reload</command></term>
 667
 668                                 <listitem><para>Reload systemd manager
 669                                 configuration. This will reload all
 670                                 unit files and recreate the entire
 671                                 dependency tree. While the daemon is
 672                                 reloaded, all sockets systemd listens
 673                                 on on behalf of user configuration will
 674                                 stay accessible.</para> <para>This
 675                                 command should not be confused with
 676                                 the <command>load</command> or
 677                                 <command>reload</command>
 678                                 commands.</para></listitem>
 679                         </varlistentry>
 680                         <varlistentry>
 681                                 <term><command>daemon-reexec</command></term>
 682
 683                                 <listitem><para>Reexecute the systemd
 684                                 manager. This will serialize the
 685                                 manager state, reexecute the process
 686                                 and deserialize the state again. This
 687                                 command is of little use except for
 688                                 debugging and package
 689                                 upgrades. Sometimes it might be
 690                                 helpful as a heavy-weight
 691                                 <command>daemon-reload</command>. While
 692                                 the daemon is reexecuted all sockets
 693                                 systemd listens on on behalf of user
 694                                 configuration will stay
 695                                 accessible.</para></listitem>
 696                         </varlistentry>
 697                         <varlistentry>
 698                                 <term><command>daemon-exit</command></term>
 699
 700                                 <listitem><para>Ask the systemd
 701                                 manager to quit. This is only
 702                                 supported for session managers
 703                                 (i.e. in conjunction with the
 704                                 <option>--session</option> option) and
 705                                 will fail otherwise.</para></listitem>
 706                         </varlistentry>
 707                         <varlistentry>
 708                                 <term><command>show-environment</command></term>
 709
 710                                 <listitem><para>Dump the systemd
 711                                 manager environment block. The
 712                                 environment block will be dumped in
 713                                 straight-forward form suitable for
 714                                 sourcing into a shell script. This
 715                                 environment block will be passed to
 716                                 all processes the manager
 717                                 spawns.</para></listitem>
 718                         </varlistentry>
 719                         <varlistentry>
 720                                 <term><command>set-environment [NAME=VALUE...]</command></term>
 721
 722                                 <listitem><para>Set one or more
 723                                 systemd manager environment variables,
 724                                 as specified on the command
 725                                 line.</para></listitem>
 726                         </varlistentry>
 727                         <varlistentry>
 728                                 <term><command>unset-environment [NAME...]</command></term>
 729
 730                                 <listitem><para>Unset one or more
 731                                 systemd manager environment
 732                                 variables. If only a variable name is
 733                                 specified it will be removed
 734                                 regardless of its value. If a variable
 735                                 and a value are specified the variable
 736                                 is only removed if it has the
 737                                 specified value.</para></listitem>
 738                         </varlistentry>
 739
 740                         <varlistentry>
 741                                 <term><command>halt</command></term>
 742
 743                                 <listitem><para>Shut down and halt the
 744                                 system. This is mostly equivalent to
 745                                 <command>start halt.target</command>
 746                                 but also prints a wall message to all
 747                                 users.</para></listitem>
 748                         </varlistentry>
 749                         <varlistentry>
 750                                 <term><command>poweroff</command></term>
 751
 752                                 <listitem><para>Shut down and
 753                                 power-off the system. This is mostly
 754                                 equivalent to <command>start
 755                                 poweroff.target</command> but also
 756                                 prints a wall message to all
 757                                 users.</para></listitem>
 758                         </varlistentry>
 759                         <varlistentry>
 760                                 <term><command>reboot</command></term>
 761
 762                                 <listitem><para>Shut down and
 763                                 reboot the system. This is mostly
 764                                 equivalent to <command>start
 765                                 reboot.target</command> but also
 766                                 prints a wall message to all
 767                                 users.</para></listitem>
 768                         </varlistentry>
 769                         <varlistentry>
 770                                 <term><command>default</command></term>
 771
 772                                 <listitem><para>Enter default
 773                                 mode. This is mostly equivalent to
 774                                 <command>start
 775                                 default.target</command>.</para></listitem>
 776                         </varlistentry>
 777                         <varlistentry>
 778                                 <term><command>rescue</command></term>
 779
 780                                 <listitem><para>Enter rescue
 781                                 mode. This is mostly equivalent to
 782                                 <command>isolate
 783                                 rescue.target</command> but also
 784                                 prints a wall message to all
 785                                 users.</para></listitem>
 786                         </varlistentry>
 787                         <varlistentry>
 788                                 <term><command>emergency</command></term>
 789
 790                                 <listitem><para>Enter emergency
 791                                 mode. This is mostly equivalent to
 792                                 <command>isolate
 793                                 emergency.target</command> but also
 794                                 prints a wall message to all
 795                                 users.</para></listitem>
 796                         </varlistentry>
 797                 </variablelist>
 798
 799         </refsect1>
 800
 801         <refsect1>
 802                 <title>Exit status</title>
 803
 804                 <para>On success 0 is returned, a non-zero failure
 805                 code otherwise.</para>
 806         </refsect1>
 807
 808         <refsect1>
 809                 <title>See Also</title>
 810                 <para>
 811                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 812                         <citerefentry><refentrytitle>systemadm</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 813                         <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
 814                         <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
 815                         <citerefentry><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 816                 </para>
 817         </refsect1>
 818
 819 </refentry>