WEBCAMD(8)

NAME
webcamd - daemon to provide access to USB webcam and DVB devices

SYNOPSIS
webcamd [-B] [-D <host:port:ndev>] [-L <host:port:ndev>] [-U <user>] [-G <group>] [-H] [-M <matchindex>] [-N <devicename>] [-S <deviceserialnumber>] [-d [ugen]<unit>.<addr>] [-i <interface or client number>] [-v <video device number>] [-m <parameter>=<value>] [-r] [-l] [-s] [-h]

DESCRIPTION
webcamd is a daemon that enables the use of hundreds of different USB webcam and DVB devices under the FreeBSD operating system. The webcam daemon is basically a port of Linux USB device drivers into userspace on FreeBSD.

webcamd requires the cuse4bsd(3) kernel module. To load the driver as a module at boot time, place the following line in loader.conf(5):

cuse4bsd_load="YES"

To start webcamd automatically at system startup, place the following line in rc.conf(5):

webcamd_enable="YES"

Once webcamd is running, supported USB web cameras and DVB devices will be available for use by other applications.

The following options are available:

-B  Run the daemon in background mode.

-d  Specify the <unit>.<addr> of the USB device to use. This option can be combined with -N and -S options.

-f  If the device requires a firmware file, specify the path to the firmware. The default firmware path is /boot/modules.

-h  Print help text showing available options.

-m  Specify the value of a parameter. Note that escaping is not supported for strings.

-i  Specify the interface number to use.

-r  Do not set realtime priority.

-S  Attach to device matching the given serial number. This option can be combined with -d and -N options.

-M  Specify the match index when using -S and -N options. This option is useful when multiple USB devices share the same serial and devicename to be able to distinguish them. Default is zero.

-N  Attach to device matching the given device name. This option can be combined with -d and -S options.

-l  List the available USB devices and the needed command line for binding to the given device.

-s  Show available parameters.

-v  Specify the video device number.

-U  Set the user identification for all character devices created by webcamd. Default value: webcamd

-G  Set the group identification for all character devices created by webcamd. Default value: webcamd

-H  Register device by the HAL daemon.

-D  Enable vTuner client support. Connect to one or more remote DVB device instead of using USB. The vTuner protocol needs eight ports for normal operation which are allocated back to back. One port for control communication and the other port for data communication. NOTE: If you want to start multiple vTuner clients in the background by use of the -B option, you need to supply a unique interface number for each client using th -i option.

-L  Enable vTuner server support. Make the DVB device available on TCP/IP instead of Cuse4BSD. If the ndev parameter is negative, all present DVB devices are mapped to TCP/IP. Else only the given number of DVB devices are mapped. The vTuner protocol needs eight ports for normal operation which are allocated back to back. One port for control communication and the other port for data communication.

EXAMPLES
With the USB device connected, determine the [ugen]<unit>.<addr> values using usbconfig(8):

    usbconfig
    ugen7.2: <product 0x0991 vendor 0x046d> at usbus7, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=ON

Create a vTuner client:

    webcamd -D 127.0.0.1:5100:1:2

Create a vTuner server:

    webcamd -L 127.0.0.1:5100:-1

NOTES
All character devices are created using the 0660 mode which gives the user and group read and write permissions.

FILES
/usr/local/etc/devd/webcamd.conf
/usr/local/etc/rc.d/webcamd
/var/run/webcamd.*.0.pid

SEE ALSO
a800(4), af9005(4), af9015(4), anysee(4), au0828(4), au6610(4), b2c2(4), benq(4), ce6230(4), cinergy(4), conex(4), cpiax(4), cxusb(4), dib0700(4), digitv(4), dtt200u(4), dtv5100(4), dw2102(4), ec168(4), em28xx(4), et61x251(4), finepix(4), friio(4), gl860(4), gl861(4), gp8psk(4), hdpvr(4), ibmcam(4), jeilinj(4), m5602(4), m920x(4), mars(4), mr800(4), mr97310a(4), nova-t(4), opera1(4), ov519(4), ov534(4), pacxxx(4), pvrusb2(4), pwc(4), s2255(4), se401(4), siano(4), sn9c102(4), sn9c20x(4), sonixj(4), spca5xx(4), sq905c(4), stk014(4), stv06xx(4), sunplus(4), t613(4), ttusb2(4), tv8532(4), umt(4), usbvision(4), uvc(4), vc032x(4), vp702x(4), vp7045(4), zc3xx(4), zr364xx(4)

AUTHORS
webcamd was written by Hans Petter Selasky hselasky@freebsd.org. This man page was written by Dru Lavigne dru@freebsd.org.