Debian Codegraph @

upstream/debian-unstable/man8/systemd-xdg-autostart-generator.8

raw
1 '\" t
2 .TH "SYSTEMD\-XDG\-AUTOSTART\-GENERATOR" "8" "" "systemd 261~rc3" "systemd-xdg-autostart-generator"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-xdg-autostart-generator \- User unit generator for XDG autostart files
24 .SH "SYNOPSIS"
25 .PP
26 /usr/lib/systemd/user\-generators/systemd\-xdg\-autostart\-generator
27 .SH "DESCRIPTION"
28 .PP
29 systemd\-xdg\-autostart\-generator
30 is a generator that creates \&.service units for
31 \m[blue]\fBXDG autostart\fR\m[]\&\s-2\u[1]\d\s+2
32 files\&. This permits desktop environments to delegate startup of these applications to
33 \fBsystemd\fR(1)
34 \&.
35 .PP
36 Units created by
37 systemd\-xdg\-autostart\-generator
38 can be started by the desktop environment using
39 "xdg\-desktop\-autostart\&.target"\&. See
40 \fBsystemd.special\fR(7)
41 for more details\&.
42 .PP
43 XDG autostart may be conditionalized using both standardized and non\-standardized keys\&. In order to handle these, the generator may create one or more
44 \fIExecCondition=\fR
45 entries\&. For non\-standardized keys, well\-known helper binaries provided by Desktop Environments are used\&. All external helpers
46 \fImust\fR
47 detect their corresponding desktop environment and
48 \fImust\fR
49 return success when run in a different environment\&. This is important as all
50 \fIExecCondition=\fR
51 directives must succeed for an application to be started\&.
52 .sp
53 .it 1 an-trap
54 .nr an-no-space-flag 1
55 .nr an-break-flag 1
56 .br
57 .B Table\ \&1.\ \& Special XDG desktop file entries that are processed
58 .TS
59 allbox tab(:);
60 lB lB.
61 T{
62 Entry
63 T}:T{
64 Handling
65 T}
66 .T&
67 l l
68 l l
69 l l
70 l l
71 l l
72 l l.
73 T{
74 \fIHidden=\fR, \fIX\-systemd\-skip=\fR
75 T}:T{
76 No service will be generated if set to true
77 T}
78 T{
79 \fIOnlyShowIn=\fR, \fINotShowIn=\fR
80 T}:T{
81 \fIExecCondition=\fR using systemd\-xdg\-autostart\-condition
82 T}
83 T{
84 \fITryExec=\fR
85 T}:T{
86 No service will be generated if the binary does not exist or cannot be executed
87 T}
88 T{
89 \fIAutostartCondition=\fR (GNOME extension)
90 T}:T{
91 \fIExecCondition=\fR using gnome\-systemd\-autostart\-condition
92 T}
93 T{
94 \fIX\-GNOME\-Autostart\-Phase=\fR
95 T}:T{
96 No service will be generated if set to any value
97 T}
98 T{
99 \fIX\-KDE\-autostart\-condition=\fR
100 T}:T{
101 \fIExecCondition=\fR using kde\-systemd\-start\-condition
102 T}
103 .TE
104 .sp 1
105 .PP
106 systemd\-xdg\-autostart\-generator
107 implements
108 \fBsystemd.generator\fR(7)\&.
109 .SH "SEE ALSO"
110 .PP
111 \fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd.target\fR(5)
112 .SH "NOTES"
113 .IP " 1." 4
114 XDG autostart
115 .RS 4
116 \%https://specifications.freedesktop.org/autostart-spec/autostart-spec-latest.html
117 .RE