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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
herbstclient(1)
===============
:doctype: manpage
:man version: {herbstluftwmversion}
NAME
----
herbstclient - sends commands to a running herbstluftwm instance via X
SYNOPSIS
--------
*herbstclient* ['OPTIONS'] 'COMMAND' ['ARGS ...']
*herbstclient* ['OPTIONS'] ['--wait'|'--idle'] ['FILTER ...']
DESCRIPTION
-----------
Sends a 'COMMAND' with its (optional) arguments 'ARGS' to a running
link:herbstluftwm.html[*herbstluftwm*(1)] instance via Xlib. If 'COMMAND' has an
output, it is printed by *herbstclient*. If output does not end with a newline,
then a newline is added to improve readability.
See link:herbstluftwm.html[*herbstluftwm*(1)] for a list of available
__COMMAND__s and their 'ARGS'.
If '--wait' or '--idle' is passed, then it waits for hooks from *herbstluftwm*.
The hook is printed, if it matches the optional 'FILTER'. __FILTER__s are
regular expressions. For a list of available hooks see *herbstluftwm*(1).
OPTIONS
-------
*-n*, *--no-newline*::
Do not print a newline if output does not end with a newline.
*-0*, *--print0*::
Use the null character as delimiter between the output of hooks.
*-l*, *--last-arg*::
When using *-i* or *-w*, only print the last argument of the hook.
*-i*, *--idle*::
Wait for hooks instead of executing commands.
*-w*, *--wait*::
Same as *--idle* but exit after first *--count* hooks.
*-c*, *--count* 'COUNT'::
Let *--wait* exit after 'COUNT' hooks were received and printed. The default of
'COUNT' is 1.
*-q*, *--quiet*::
Do not print error messages if herbstclient cannot connect to the running
herbstluftwm instance.
*-v*, *--version*::
Print the herbstclient version. To get the herbstluftwm version, use
*herbstclient version*.
*-h*, *--help*::
Print the herbstclient usage with its command line options.
ENVIRONMENT VARIABLES
---------------------
DISPLAY::
Specifies the 'DISPLAY' to use, i.e. where *herbstluftwm*(1) is running.
EXIT STATUS
-----------
Returns the exit status of the 'COMMAND' execution in *herbstluftwm*(1) server.
*0*::
Success.
other::
Failure. See link:herbstluftwm.html[*herbstluftwm*(1)] for a list of error
codes.
BUGS
----
It waits endlessly for a response from *herbstluftwm* (there is no timeout yet).
See the *herbstluftwm* distribution BUGS file.
COMMUNITY
---------
Feel free to join the IRC channel '#herbstluftwm' on 'irc.freenode.net'.
AUTHOR
------
*herbstclient* was written by Thorsten Wißmann. All contributors are listed in
the *herbstluftwm* distribution AUTHORS file.
RESOURCES
---------
Homepage: <http://herbstluftwm.org>
Github page: <http://github.com/herbstluftwm/herbstluftwm>
Patch submission and bug reporting:
hlwm@lists.herbstluftwm.org
COPYING
-------
Copyright 2011-2014 Thorsten Wißmann. All rights reserved.
This software is licensed under the "Simplified BSD License". See LICENSE for
details.
// vim: tw=80 ft=asciidoc
|