herbstclient(1) [debian man page]

HERBSTCLIENT(1) 														   HERBSTCLIENT(1)

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 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 herbstluftwm(1) for a list of available COMMANDs 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.

       -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.

       -h, --help
	   Print the herbstclient usage with its command line options.

ENVIRONMENT VARIABLES

       DISPLAY
	   Specifies the DISPLAY to use, e.g. where herbstluftwm(1) is running.

EXIT STATUS

       Returns the exit status of the COMMAND execution in herbstluftwm(1) server.

       0
	   Success.

       other
	   Failure. See 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 WiBmann.

RESOURCES

       Gitweb: http://git.cs.fau.de/?p=re06huxa/herbstluftwm

COPYING

       Copyright 2011-2012 Thorsten WiBmann. All rights reserved.

       This software is licensed under the "Simplified BSD License". See LICENSE for details.

  herbstluftwm 0.3						    2012-04-13							   HERBSTCLIENT(1)

TIMEOUT(1)							   User Commands							TIMEOUT(1)

NAME

       timeout - run a command with a time limit

SYNOPSIS

       timeout [OPTION] DURATION COMMAND [ARG]...
       timeout [OPTION]

DESCRIPTION

       Start COMMAND, and kill it if still running after DURATION.

       Mandatory arguments to long options are mandatory for short options too.

       --preserve-status

	      exit with the same status as COMMAND, even when the

	      command times out

       --foreground

	      when not running timeout directly from a shell prompt,

	      allow COMMAND to read from the TTY and get TTY signals; in this mode, children of COMMAND will not be timed out

       -k, --kill-after=DURATION

	      also send a KILL signal if COMMAND is still running

	      this long after the initial signal was sent

       -s, --signal=SIGNAL

	      specify the signal to be sent on timeout;

	      SIGNAL may be a name like 'HUP' or a number; see 'kill -l' for a list of signals

       --help
	      display this help and exit

       --version
	      output version information and exit

       DURATION is a floating point number with an optional suffix: 's' for seconds (the default), 'm' for minutes, 'h' for hours or 'd' for days.

       If  the command times out, and --preserve-status is not set, then exit with status 124.	Otherwise, exit with the status of COMMAND.  If no
       signal is specified, send the TERM signal upon timeout.	The TERM signal kills any process that does not block or catch	that  signal.	It
       may be necessary to use the KILL (9) signal, since this signal cannot be caught, in which case the exit status is 128+9 rather than 124.

BUGS

       Some platforms don't currently support timeouts beyond the year 2038.

AUTHOR

       Written by Padraig Brady.

REPORTING BUGS

       GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
       Report timeout translation bugs to <http://translationproject.org/team/>

COPYRIGHT

       Copyright (C) 2017 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       kill(1)

       Full documentation at: <http://www.gnu.org/software/coreutils/timeout>
       or available locally via: info '(coreutils) timeout invocation'

GNU coreutils 8.28						   January 2018 							TIMEOUT(1)