summaryrefslogtreecommitdiff
path: root/doc/man/hal-find-by-property.1.in
blob: f8f8cdc1c24cb7750b95f707ae629a572589cb0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
.\" 
.\" hal-find-by-property manual page.
.\" Copyright (C) 2007 David Zeuthen <david@fubar.dk>
.\"
.TH HAL-FIND-BY-PROPERTY 1
.SH NAME
hal-find-by-property \- find device objects by property matching
.SH SYNOPSIS
.PP
.B hal-find-by-property
[options]

.SH DESCRIPTION

\fIhal-get-property\fP finds device object in
the
.B HAL 
device database by looking at device properties. For
more information about both the big picture and specific
.B HAL
properties, refer to the \fIHAL spec\fP which can be found in
.I "@docdir@/spec/hal-spec.html"
depending on the distribution.

.SH OPTIONS
The following options are supported:
.TP
.I "--key"
The name of the property.
.TP
.I "--string"
String value of the property
.TP
.I "--verbose"
Verbose output.
.TP
.I "--help"
Print out usage.
.TP
.I "--version"
Print the version.

.SH RETURN VALUE
.PP
If devices matching the given property are found each UDI (\fIUnique
Device Identifier\fP) is printed on stdout and the program exits with
exit code 0. If no devices are found or an error occured, the program
exits with a non-zero exit code.

.SH BUGS
.PP
Please send bug reports to either the distribution or the HAL
mailing list, see 
.I "http://lists.freedesktop.org/mailman/listinfo/hal"
on how to subscribe.

.SH SEE ALSO
.PP
\&\fIhald\fR\|(8), 
\&\fIlshal\fR\|(1), 
\&\fIhal-set-property\fR\|(1),
\&\fIhal-get-property\fR\|(1),
\&\fIhal-find-by-capability\fR\|(1),
\&\fIdbus-send\fR\|(1)

.SH AUTHOR
Written by David Zeuthen <david@fubar.dk> with a lot of help from many
others.