summaryrefslogtreecommitdiff
path: root/util/mc-wait-for-name.1.in
blob: e4ce204e57a715b0e74226f93dfbf35dfac9e923 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
.TH MC-WAIT-FOR-NAME "1" "July 2009" "Telepathy" "Utilities"
\" Copyright © 2009 Collabora Ltd. <http://www.collabora.co.uk/>
\" This document may be distributed under the same terms as
\" telepathy-mission-control itself.
.SH NAME
mc-wait-for-name \- run until a D-Bus name appears on the session bus
.SH SYNOPSIS
.B mc-wait-for-name
.I WELL-KNOWN-NAME
.PP
.nf
.B [D-BUS Service]
.BI Name= org.freedesktop.Telepathy.Client.Something
.BI Exec=@bindir@/mc-wait-for-name " org.freedesktop.Telepathy.Client.Something"
.fi
.SH DESCRIPTION
.B mc-wait-for-name
runs until a bus name appears, then exits successfully. This can be used as a
service-activation helper for a bus name that is not directly activatable, but
will be provided automatically (after a while) by the desktop session.
.SH EXIT STATUS
.TP
0
The bus name eventually appeared.
.TP
64 (EX_USAGE)
Invocation error (too many or too few arguments, or the bus name given was
not a syntactically valid well-known bus name).
.TP
69 (EX_UNAVAILABLE)
mc-wait-for-name was unable to connect to the session bus.
.TP
75 (EX_TEMPFAIL)
The name did not appear within a reasonable time.
.SH OPTIONS
There are no additional command-line options.
.SH BUGS
The "reasonable time" to wait is currently hard-coded.