'\" t
.\"     Title: usbguard-daemon
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 09/23/2024
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "USBGUARD\-DAEMON" "8" "09/23/2024" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
usbguard-daemon \- USBGuard daemon
.SH "SYNOPSIS"
.sp
usbguard\-daemon [OPTIONS]
.SH "DESCRIPTION"
.sp
The \fBusbguard\-daemon\fR is the main component of the USBGuard software framework\&. It runs as a service in the background and enforces the USB device authorization policy for all USB devices\&. The policy is defined by a set of rules using a rule language described in \fBusbguard\-rules\&.conf\fR(5)\&. The policy and the authorization state of USB devices can be modified during runtime using the \fBusbguard\fR(1) tool\&.
.SH "OPTIONS"
.PP
\fB\-d\fR
.RS 4
Enable debugging messages in the log\&.
.RE
.PP
\fB\-f\fR
.RS 4
Enable classical daemon behavior (fork at start, sysV compliant)\&.
.RE
.PP
\fB\-s\fR
.RS 4
Log to syslog\&.
.RE
.PP
\fB\-k\fR
.RS 4
Log to console\&. (default)
.RE
.PP
\fB\-K\fR
.RS 4
Disable Logging to console\&.
.RE
.PP
\fB\-l\fR \fIpath\fR
.RS 4
Log to a file at
\fIpath\fR\&.
.RE
.PP
\fB\-p\fR \fIpath\fR
.RS 4
Write PID to a file at
\fIpath\fR
(default:
\fI/var/run/usbguard\&.pid\fR)\&.
.RE
.PP
\fB\-c\fR \fIpath\fR
.RS 4
Load configuration from a file at
\fIpath\fR
(default:
\fI/etc/usbguard/usbguard\-daemon\&.conf\fR)\&.
.RE
.PP
\fB\-P\fR
.RS 4
Disable permissions check on conf and policy files (default:
\fI/etc/usbguard/usbguard\-daemon\&.conf\fR)\&.
.RE
.PP
\fB\-C\fR
.RS 4
Drop capabilities to limit privileges of the process\&.
.RE
.PP
\fB\-W\fR
.RS 4
Use a seccomp allowlist to limit available syscalls to the process\&.
.RE
.PP
\fB\-h\fR
.RS 4
Show the help/usage screen\&.
.RE
.SH "SECURITY CONSIDERATIONS"
.sp
The daemon provides the USBGuard public IPC interface\&. Depending on your distribution defaults, the access to this interface is limited to a certain group or a specific user only\&. Please refer to the usbguard\-daemon\&.conf(5) man page for more information on how to configure the ACL correctly\&. \fBDo not leave the ACL unconfigured as that will expose the IPC interface to all local users\&. That will allow them to manipulate the authorization state of USB devices and modify the USBGuard policy\fR\&.
.SH "SEE ALSO"
.sp
usbguard\-daemon\&.conf(5), usbguard\-rules\&.conf(5), usbguard(1)
.SH "BUGS"
.sp
If you find a bug in this software or if you\(cqd like to request a feature to be implemented, please file a ticket at https://github\&.com/USBGuard/usbguard/issues/new\&.
.SH "AUTHOR"
.sp
USBGuard was originally written by Daniel Kopeček\&. Many people have contributed to it\&.
.SH "RESOURCES"
.sp
Main web site: https://usbguard\&.github\&.io/
.SH "COPYING"
.sp
License GPLv2+: GNU GPL version 2 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\&.