Debian Codegraph @

upstream/debian-unstable/man8/scanbd.8

raw
1 .\" $Id: scanbd.man 201 2014-12-12 07:35:03Z wimalopaan $
2 .TH scanbd 8 "02 Jan 2013" "scanbd 1.92" "Scanner button daemon"
3 .IX scanbd
4 .SH NAME
5 scanbd\- Scanner button monitoring daemon
6 .SH SYNOPSIS
7 .I Polling mode:
8 .PP
9 .B scanbd
10 .B [\-c
11 .I configfile
12 .B ] [\-f]
13 .BI [\-d [debuglevel]
14 .B ]
15 .PP
16 .I Manager-mode
17 .PP
18 The manager mode of
19 .B scanbd
20 that can be triggered by the
21 .B \-m
22 option is not documented in this man-page but in
23 .BR scanbm (8)
24 .
25 .SH DESCRIPTION
26 .B scanbd
27 is a scanner button monitoring daemon that can trigger execution of scripts when
28 a button on a scanner is pressed.
29 scanbd (the scanner button daemon) opens and polls the scanner
30 and therefore locks the device. So no other application can access the device
31 directly (open the /dev/..., or via libusb, etc).
32 .PP
33 To enable scanning from applications, we use scanbm as a "proxy" for
34 saned to access the scanner from an application. scanbm
35 listens for requests on the saned network port for scanning requests.
36 If a scan request arrives, scanbm
37 requests the scanbd daemon to release the scanner.
38 Then it starts the real saned which scans and sends the data back
39 to the requesting application. When the scanning is done and saned exits, the
40 scanbm daemon tells scanbd to resume polling the scanner.
41 .PP
42 scanbd polls the scanner regularly (the interval can be set in
43 .B scanbd.conf
44 ) and monitors for any scanner button to be pressed. If it detects a button press
45 it triggers execution of the appropriate script as defined in
46 .B scanbd.conf
47 .
48 .SH OPTIONS
49 .TP
50 .BI \-c " configfile" " \-\-config" =configfile
51 Use
52 .I configfile
53 instead of the default /etc/scanbd/scanbd.conf configuration file.
54 .TP
55 .BI \-d [debuglevel] " \-\-debug" [=debuglevel]
56 turn debug mode on. If specified, set the debug level to
57 .I debuglevel
58 .br
59 1 = error
60 .br
61 2 = warn
62 .br
63 3 = info
64 .br
65 4 - 7 = debug)
66 .TP
67 .B \-f \-\-foreground
68 Run scanbd in the foreground
69 .SH SIGNALS
70 .TP
71 .B SIGUSR1
72 Stop polling and relase the scanner (used by
73 .B scanbm
74 )
75 .TP
76 .B SIGUSR1
77 Resume polling (used by
78 .B scanbm
79 )
80 .TP
81 .B SIGHUP
82 Rescan for available devices (useful when no automatic detection is available (HAL, UDEV) )
83 .SH MAIN SCANBD CONFIGURATION
84 scanbd and scanbm are configured trough scanbd.conf (/etc/scanbd/scanbd.conf).
85 The distributed scanbd.conf
86 contains a detailed explantion of the configuration options.
87 .PP
88 The
89 .B \-c
90 option can be used to override the default configuration file.
91 .SH "SEE ALSO"
92 .BR scanbm (8),
93 .BR sane (7),
94 .BR saned (8),
95 .BR sane\-dll (5),
96 .BR sane\-net (5)
97 .BR /etc/scanbd/scanbd.conf
98 .br
99 .I http://scanbd.sourceforge.net
100 .SH AUTHOR
101 Louis Lagendijk