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

« back to all changes in this revision

Viewing changes to man/systemd.exec.5

  • 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
[ 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:
2
2
.\"     Title: systemd.exec
3
3
.\"    Author: Lennart Poettering <lennart@poettering.net>
4
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
 
.\"      Date: 10/11/2011
 
5
.\"      Date: 03/16/2012
6
6
.\"    Manual: systemd.exec
7
7
.\"    Source: systemd
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "SYSTEMD\&.EXEC" "5" "10/11/2011" "systemd" "systemd.exec"
 
10
.TH "SYSTEMD\&.EXEC" "5" "03/16/2012" "systemd" "systemd.exec"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * Define some portability stuff
13
13
.\" -----------------------------------------------------------------
202
202
\fBtty\fR,
203
203
\fBsyslog\fR,
204
204
\fBkmsg\fR,
 
205
\fBjournal\fR,
 
206
\fBsyslog+console\fR,
205
207
\fBkmsg+console\fR,
206
 
\fBsyslog+console\fR
 
208
\fBjournal+console\fR
207
209
or
208
210
\fBsocket\fR\&. If set to
209
211
\fBinherit\fR
221
223
\fBkmsg\fR
222
224
connects it with the kernel log buffer which is accessible via
223
225
\fBdmesg\fR(1)\&.
224
 
\fBsyslog+console\fR
 
226
\fBjournal\fR
 
227
connects it with the journal which is accessible via
 
228
\fBsystemd-journalctl\fR(1)
 
229
(Note that everything that is written to syslog or kmsg is implicitly stored in the journal as well, those options are hence supersets of this one)\&.
 
230
\fBsyslog+console\fR,
 
231
\fBjournal+console\fR
225
232
and
226
233
\fBkmsg+console\fR
227
234
work similarly but copy the output to the system console as well\&.
231
238
\fBDefaultStandardOutput=\fR
232
239
in
233
240
\fBsystemd.conf\fR(5), which defaults to
234
 
\fBsyslog\fR\&.
 
241
\fBjournal\fR\&.
235
242
.RE
236
243
.PP
237
244
\fIStandardError=\fR
390
397
.RS 4
391
398
If this is a socket\-activated service this sets the tcpwrap service name to check the permission for the current connection with\&. This is only useful in conjunction with socket\-activated services, and stream sockets (TCP) in particular\&. It has no effect on other socket types (e\&.g\&. datagram/UDP) and on processes unrelated to socket\-based activation\&. If the tcpwrap verification fails daemon start\-up will fail and the connection is terminated\&. See
392
399
\fBtcpd\fR(8)
393
 
for details\&.
 
400
for details\&. Note that this option may be used to do access control checks only\&. Shell commands and commands described in
 
401
\fBhosts_options\fR(5)
 
402
are not supported\&.
394
403
.RE
395
404
.PP
396
405
\fICapabilityBoundingSet=\fR
443
452
(and the appropriate group), and he/she can create subgroups as well as add processes to the group\&.
444
453
.RE
445
454
.PP
 
455
\fIControlGroupPersistent=\fR
 
456
.RS 4
 
457
Takes a boolean argument\&. If true, the control groups created for this unit will be marked to be persistent, i\&.e\&. systemd will not remove them when stopping the unit\&. The default is false, meaning that the control groups will be removed when the unit is stopped\&. For details about the semantics of this logic see
 
458
\m[blue]\fBPaxControlGroups\fR\m[]\&\s-2\u[3]\d\s+2\&.
 
459
.RE
 
460
.PP
446
461
\fIControlGroupAttribute=\fR
447
462
.RS 4
448
463
Set a specific control group attribute for executed processes, and (if needed) add the the executed processes to a cgroup in the hierarchy of the controller the attribute belongs to\&. Takes two space\-separated arguments: the attribute name (syntax is
467
482
Assign the specified overall CPU time shares to the processes executed\&. Takes an integer value\&. This controls the
468
483
cpu\&.shares
469
484
control group attribute, which defaults to 1024\&. For details about this control group attribute see
470
 
\m[blue]\fBsched\-design\-CFS\&.txt\fR\m[]\&\s-2\u[3]\d\s+2\&.
 
485
\m[blue]\fBsched\-design\-CFS\&.txt\fR\m[]\&\s-2\u[4]\d\s+2\&.
471
486
.RE
472
487
.PP
473
488
\fIMemoryLimit=\fR, \fIMemorySoftLimit=\fR
477
492
and
478
493
memory\&.soft_limit_in_bytes
479
494
control group attributes\&. For details about these control group attributes see
480
 
\m[blue]\fBmemory\&.txt\fR\m[]\&\s-2\u[4]\d\s+2\&.
 
495
\m[blue]\fBmemory\&.txt\fR\m[]\&\s-2\u[5]\d\s+2\&.
481
496
.RE
482
497
.PP
483
498
\fIDeviceAllow=\fR, \fIDeviceDeny=\fR
488
503
and
489
504
devices\&.deny
490
505
control group attributes\&. For details about these control group attributes see
491
 
\m[blue]\fBdevices\&.txt\fR\m[]\&\s-2\u[5]\d\s+2\&.
 
506
\m[blue]\fBdevices\&.txt\fR\m[]\&\s-2\u[6]\d\s+2\&.
492
507
.RE
493
508
.PP
494
509
\fIBlockIOWeight=\fR
498
513
and
499
514
blkio\&.weight_device
500
515
control group attributes, which default to 1000\&. Use this option multiple times to set weights for multiple devices\&. For details about these control group attributes see
501
 
\m[blue]\fBblkio\-controller\&.txt\fR\m[]\&\s-2\u[6]\d\s+2\&.
 
516
\m[blue]\fBblkio\-controller\&.txt\fR\m[]\&\s-2\u[7]\d\s+2\&.
502
517
.RE
503
518
.PP
504
519
\fIBlockIOReadBandwidth=\fR, \fIBlockIOWriteBandwidth=\fR
508
523
and
509
524
blkio\&.write_bps_device
510
525
control group attributes\&. Use this option multiple times to set bandwith limits for multiple devices\&. For details about these control group attributes see
511
 
\m[blue]\fBblkio\-controller\&.txt\fR\m[]\&\s-2\u[6]\d\s+2\&.
 
526
\m[blue]\fBblkio\-controller\&.txt\fR\m[]\&\s-2\u[7]\d\s+2\&.
512
527
.RE
513
528
.PP
514
529
\fIReadWriteDirectories=\fR, \fIReadOnlyDirectories=\fR, \fIInaccessibleDirectories=\fR
561
576
\fBgetty\fR
562
577
implementations where utmp/wtmp entries must be created and cleared before and after execution\&. If the configured string is longer than four characters it is truncated and the terminal four characters are used\&. This setting interprets %I style string replacements\&. This setting is unset by default, i\&.e\&. no utmp/wtmp entries are created or cleaned up for this service\&.
563
578
.RE
 
579
.PP
 
580
\fIIgnoreSIGPIPE=\fR
 
581
.RS 4
 
582
Takes a boolean argument\&. If true causes SIGPIPE to be ignored in the executed process\&. Defaults to true, since SIGPIPE generally is useful only in shell pipelines\&.
 
583
.RE
564
584
.SH "SEE ALSO"
565
585
.PP
566
586
 
589
609
\%http://www.kernel.org/doc/Documentation/cgroups/cgroups.txt
590
610
.RE
591
611
.IP " 3." 4
 
612
PaxControlGroups
 
613
.RS 4
 
614
\%http://www.freedesktop.org/wiki/Software/systemd/PaxControlGroups
 
615
.RE
 
616
.IP " 4." 4
592
617
sched-design-CFS.txt
593
618
.RS 4
594
619
\%http://www.kernel.org/doc/Documentation/scheduler/sched-design-CFS.txt
595
620
.RE
596
 
.IP " 4." 4
 
621
.IP " 5." 4
597
622
memory.txt
598
623
.RS 4
599
624
\%http://www.kernel.org/doc/Documentation/cgroups/memory.txt
600
625
.RE
601
 
.IP " 5." 4
 
626
.IP " 6." 4
602
627
devices.txt
603
628
.RS 4
604
629
\%http://www.kernel.org/doc/Documentation/cgroups/devices.txt
605
630
.RE
606
 
.IP " 6." 4
 
631
.IP " 7." 4
607
632
blkio-controller.txt
608
633
.RS 4
609
634
\%http://www.kernel.org/doc/Documentation/cgroups/blkio-controller.txt