← Back to branch summary

~ubuntu-branches/debian/squeeze/hal/squeeze

« back to all changes in this revision

Viewing changes to doc/man/hald.8

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2007-10-23 12:33:58 UTC
  • Revision ID: james.westby@ubuntu.com-20071023123358-xaf8mjc5n84d5gtz
Tags: upstream-0.5.10
Import upstream version 0.5.10

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/hald.8
1
 
.\" 
2
 
.\" hald manual page.
3
 
.\" Copyright (C) 2007 David Zeuthen <david@fubar.dk>
4
 
.\"
5
 
.TH HALD 8
6
 
.SH NAME
7
 
hald \- HAL daemon
8
 
.SH SYNOPSIS
9
 
.PP
10
 
.B hald
11
 
[options]
12
 
 
13
 
.SH DESCRIPTION
14
 
 
15
 
\fIhald\fP is a daemon that maintains a database of the devices
16
 
connected to the system system in real-time. The daemon connects to
17
 
the \fID-Bus\fP system message bus to provide an API that applications
18
 
can use to discover, monitor and invoke operations on devices. For
19
 
more information about both the big picture and specific API details,
20
 
refer to the \fIHAL spec\fP which can be found in
21
 
.I "/usr/share/doc/hal-0.5.9/spec/hal-spec.html"
22
 
depending on the distribution.
23
 
 
24
 
.SH OPTIONS
25
 
The following options are supported:
26
 
.TP
27
 
.I "--daemon=yes|no"
28
 
Specify whether to run in the foreground or the background.
29
 
.TP
30
 
.I "--verbose=yes|no"
31
 
Enable verbose debug output.
32
 
.TP
33
 
.I "--help"
34
 
Print out usage.
35
 
.TP
36
 
.I "--version"
37
 
Print the version of the daemon and exit.
38
 
 
39
 
.SH BUGS AND DEBUGGING
40
 
.PP
41
 
Please send bug reports to either the distribution or the HAL
42
 
mailing list, see 
43
 
.I "http://lists.freedesktop.org/mailman/listinfo/hal"
44
 
on how to subscribe.
45
 
 
46
 
First, to obtain useful debug traces you will need to have
47
 
.B debuginfo
48
 
packages installed. On a Fedora system this is in the 
49
 
.B hal-debuginfo 
50
 
package and can be installed via the
51
 
.I yum
52
 
update program. 
53
 
 
54
 
Second, shut down the existing 
55
 
.B hald
56
 
daemon instance; on a Fedora system this is achieved by
57
 
 
58
 
.I "/etc/init.d/haldaemon stop"
59
 
 
60
 
After having shut down the daemon, you might want to run
61
 
 
62
 
.I "pkill hald"
63
 
 
64
 
to ensure that all the helper processe of
65
 
.B hald
66
 
are killed too. To start the HAL daemon, use
67
 
 
68
 
.I "/usr/sbin/hald --daemon=no --verbose=yes"
69
 
 
70
 
If the daemon crashes, you can start it under a debugger via
71
 
 
72
 
.I "gdb /usr/sbin/hald"
73
 
 
74
 
and then typing
75
 
 
76
 
.I "run --daemon=no --verbose=yes"
77
 
 
78
 
at the 
79
 
.B "(gdb)"
80
 
prompt. To capture a back trace, use the
81
 
.B "bt"
82
 
command and attach this to the bug report.
83
 
 
84
 
Please also attach the output of \&\fIlshal\fR\|(1) in the bug report
85
 
if possible (it's not possible if the
86
 
.B "hald"
87
 
daemon crashed). If the nature of the bug has to do with hotplugging,
88
 
attach two outputs of \&\fIlshal\fR\|(1) - one before the device
89
 
hotplug event and one after.
90
 
 
91
 
.SH SEE ALSO
92
 
.PP
93
 
\&\fIudev\fR\|(7), 
94
 
\&\fIdbus-daemon\fR\|(1), 
95
 
\&\fIlshal\fR\|(1), 
96
 
\&\fIhal-set-property\fR\|(1),
97
 
\&\fIhal-get-property\fR\|(1),
98
 
\&\fIhal-find-by-property\fR\|(1),
99
 
\&\fIhal-find-by-capability\fR\|(1),
100
 
\&\fIhal-is-caller-locked-out\fR\|(1)
101
 
 
102
 
.SH AUTHOR
103
 
Written by David Zeuthen <david@fubar.dk> with a lot of help from many
104
 
others.
105