.\" 
.\" hal-find-by-capability manual page.
.\" Copyright (C) 2007 David Zeuthen <david@fubar.dk>
.\"
.TH HAL-FIND-BY-CAPABILITY 1
.SH NAME
hal-find-by-capability \- find device objects by capability matching
.SH SYNOPSIS
.PP
.B hal-find-by-capability
[options]

.SH DESCRIPTION

\fIhal-get-capability\fP finds device object in
the
.B HAL 
device database by looking at device capabilities. 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 "/usr/share/doc/hal-doc/spec/hal-spec.html"
depending on the distribution.

.SH OPTIONS
The following options are supported:
.TP
.I "--capability"
The name of the capability.
.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 capability 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-property\fR\|(1),
\&\fIdbus-send\fR\|(1)

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