mirror of https://github.com/nymea/nymea.git
119 lines
4.1 KiB
Groff
119 lines
4.1 KiB
Groff
.\" Manpage for guhd.
|
||
.\" Contact simon.stuerz@guh.io to correct errors or typos.
|
||
.TH man 1 "June 2016" "1.7" "guhd man page"
|
||
.SH NAME
|
||
guhd \- An open source IoT (Internet of Things) server
|
||
.SH SYNOPSIS
|
||
.B guhd
|
||
[\fIOPTION\fR]
|
||
.SH DESCRIPTION
|
||
guh (/[guːh]/) is an open source IoT (Internet of Things) server,
|
||
which allows to control a lot of different devices from many different
|
||
manufacturers. With the powerful rule engine you are able to connect any
|
||
device available in the system and create individual scenes and behaviors
|
||
for your environment.
|
||
.SH OPTIONS
|
||
.TP
|
||
\fB\-h\fR, \fB\-\-help\fR
|
||
Displays this help.
|
||
.TP
|
||
\fB\-v\fR, \fB\-\-version\fR
|
||
Displays version information.
|
||
.TP
|
||
\fB\-n\fR, \fB\-\-no\-daemon\fR
|
||
Run guhd in the foreground, not as daemon.
|
||
.TP
|
||
\fB\-p\fR, \fB\-\-print\-all\fR
|
||
Enables all debug categories. This parameter overrides all debug
|
||
category parameters.
|
||
.TP
|
||
\fB\-d\fR, \fB\-\-debug\fR, \fB\<[No\]DebugCategory>\fR
|
||
Debug categories to enable. In order to disable a category which is enabled by
|
||
default, you can add \"No\" to the category. Warnings from all
|
||
categories will be printed unless they are explicitly muted with "NoWarnings".
|
||
.RS
|
||
.TP
|
||
\fBMain\ debug\ categories:\fR
|
||
.IP \fIApplication\fR\ (default\ enabled)
|
||
Print the debug messages from the core application.
|
||
.IP \fIAvahi\fR\ (default\ disabled)
|
||
Print the debug messages from the avahi resource.
|
||
.IP \fICloud\fR\ (default\ enabled)
|
||
Print the debug messages from the Cloud connections in guh.
|
||
.IP \fIConnection\fR\ (default\ enabled)
|
||
Print the debug messages from the TCP connections in guh.
|
||
.IP \fIDeviceManager\fR\ (default\ enabled)
|
||
Print the debug messages from the device manager.
|
||
.IP \fIHardware\fR\ (default\ disabled)
|
||
Print the debug messages from hardware resources in guh.
|
||
.IP \fIJsonRpc\fR\ (default\ disabled)
|
||
Print the debug messages from JSON-RPC API.
|
||
.IP \fILogEngine\fR\ (default\ disabled)
|
||
Print the debug messages from logging engine.
|
||
.IP \fIOAuth2\fR\ (default\ disabled)
|
||
Print the debug messages of the OAuth2 resource.
|
||
.IP \fIRest\fR\ (default\ disabled)
|
||
Print the debug messages from REST API.
|
||
.IP \fIRuleEngine\fR\ (default\ enabled)
|
||
Print the debug messages from the rule engine.
|
||
.IP \fITcpServer\fR\ (default\ disabled)
|
||
Print the debug messages from the TCP server.
|
||
.IP \fIWarning\fR\ (default\ enabled)
|
||
Print warnings.
|
||
.IP \fIWebServer\fR\ (default\ disabled)
|
||
Print the debug messages from the web server.
|
||
.IP \fIWebSocketServer\fR\ (default\ disabled)
|
||
Print the debug messages from the websocket server.
|
||
.TP
|
||
\fBDebug\ categories\ for\ plugins:\fR
|
||
Since guh loads the plugins dynamically, the list of supported
|
||
plugin debug categories depends on your plugin installation. Please use
|
||
the \fB-h\fR command to see which categories are available for your system.
|
||
.SH EXAMPLES
|
||
.TP
|
||
To start guhd in the foreground and read the debug messages from the Hardware:
|
||
.IP
|
||
$ guhd -n -d Hardware
|
||
.TP
|
||
To start guhd in the foreground, disable debug messages from the DeviceManager
|
||
and enable debug messages for JsonRpc and LogEngine:
|
||
.IP
|
||
$ guhd -n -d NoDeviceManager -d JsonRpc -d LogEngine
|
||
.SH FILES
|
||
The server config file: \fI/etc/guh/guhd.conf\fR
|
||
.br
|
||
The devices config file: \fI/etc/guh/devices.conf\fR
|
||
.br
|
||
The rules config file: \fI/etc/guh/rules.conf\fR
|
||
.br
|
||
The plugins config file: \fI/etc/guh/plugins.conf\fR
|
||
.br
|
||
The log file: \fI/var/log/guhd.log\fR
|
||
.br
|
||
The logrotate config file: \fI/etc/logrotate.d/guhd\fR
|
||
.br
|
||
The logging database: \fI/var/log/guhd.sqlite\fR
|
||
.br
|
||
The systemd unit file: \fI/lib/systemd/system/guhd.service\fR
|
||
.br
|
||
The plugins directory: \fI/usr/lib/guh/plugins/\fR
|
||
.SH SEE ALSO
|
||
Full developer documentation at: <https://developers.guh.io>
|
||
.br
|
||
Wiki on github: <https://github.com/guh/guh/wiki>
|
||
.SH "REPORTING BUGS"
|
||
Issue tracker on github: <https://github.com/guh/guh/issues>
|
||
.br
|
||
How to report bugs: <https://github.com/guh/guh/wiki/Reporting-bugs>
|
||
.SH AUTHOR
|
||
Written by Simon Stürz and Michael Zanetti
|
||
.SH COPYRIGHT
|
||
Copyright \(co 2014-2016 guh GmbH.
|
||
.br
|
||
|
||
License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
|
||
.br
|
||
This is free software: you are free to change and redistribute it.
|
||
.br
|
||
There is NO WARRANTY, to the extent permitted by law.
|