FreeBSD manual

download PDF document: webcamd.8.pdf

WEBCAMD(8) FreeBSD System Manager's Manual WEBCAMD(8) NAME webcamd - daemon which provide access to USB webcam, USB DVB, USB radio, USB input, USB tablet and more devices SYNOPSIS webcamd [-B] [-D <host:port:ndev>] [-L <host:port:ndev>] [-U <user>] [-G <group>] [-M <matchindex>] [-N <devicename>] [-S <deviceserialnumber>] [-d [ugen]<unit>.<addr>] [-i <interface or client number>] [-v <video device number>] [-c <devname>] [-m <parameter>=<value>] [-r] [-l] [-s] [-h] DESCRIPTION webcamd is a daemon that enables the use of hundreds of different USB webcam, USB DVB, USB radio, USB input, USB tablet and more devices under the FreeBSD operating system. The webcamd daemon is basically a port of Linux USB device drivers into userspace in FreeBSD. webcamd requires the cuse(3) kernel module. To load the driver as a module at boot time, place the following line in loader.conf(5): cuse_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 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 -v Specify the video device number. -c Create device of specified type. Valid values: v4l2loopback For multiple v4l2loopback devices, specify -m v4l2loopback.devices=2 -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 -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 cuse(3). 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), AUTHORS webcamd was written by Hans Petter Selasky hselasky@freebsd.org. This man page was written by Dru Lavigne dru@freebsd.org. FreeBSD July 28, 2021 FreeBSD