bkeyd.conf

NAME

bkeyd.conf - bkeyd configuration file

DESCRIPTION

bkeyd.conf is the configuration file for bkeyd. If not specified using --config when running bkeyd, bkeyd uses /etc/bkeyd.conf as the configuration file.

OPTIONS

log stream file

Specifies a file to log all messages from stream to. stream can be any of 1, 2, or a for regular messages, error messages, or both respectively. Note that this option is ignored if a log file is set for a matching stream via a command line flag.

redirect stream file

Specifies a file to redirect stream to for commands bound to hot-keys that are run. stream can be any of 1, 2, or a for stdout, stderr, or both respectively. Note that this option is ignored if a file is set for a matching stream via a command line flag.

suppress stream

'suppress stream' is equivalent to 'redirect stream /dev/null'

keyboard device

Specifies a input device to listen to by the devices filesystem path. If device is all, bkeyd will listen to all input devices available under /dev/input/. If no keyboards are specified in either the configuration file or by command line flag, the default of all is used. Note that this option is ignored if the flag --no-keyboards is passed to bkeyd.

check time

Specifies the time in seconds befour checking for new devices. Must be either a non-negative integer value or the special case never which is equivalent to 0. If time is 0 or never, bkeyd will not automatically check for new devices. Note that bkeyd works using alarm(), therefore bkeyd can be told manually to check for new devices by passing the signal SIGALRM even if time is zero. The default value for time is 1. Note that this option is ignored if the flag --check is passed to bkeyd.

shell file

Specifies the shell that commands are to be run in. The default value is /bin/sh. Note that this option is ignored if the flag --shell is passed to bkeyd.

bind hotkey

Binds a list of commands to a hot-key. All lines immediately following this option beggining with a white-space character are interpreted as the commands for this binding. To find the name of a hot-key, use 'bkeyd --test'.

EXAMPLE

see /etc/bkeyd.conf.example

COPYRIGHT

Copyright © 2013 Benjamin Bolton. 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

bkeyd(1)

AUTHOR

Benjamin Bolton (benjamin@bennybolton.com)