Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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_] [-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, 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 cuse4bsd(3) kernel module from ports in versions of
     FreeBSD prior to 11.x and the cuse(3) kernel module in versions of
     FreeBSD starting at 11.0.	To load	the driver as a	module at boot time,
     place the following line in loader.conf(5):

	    # FreeBSD <	11.x, package from ports
	    cuse4bsd_load="YES"

	    # FreeBSD >= 11.x, part of default kernel build
	    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 sup-
	     ported 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	commu-
	     nication.	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.

FreeBSD			       December	10, 2016		       FreeBSD

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | NOTES | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=webcamd&manpath=FreeBSD+11.1-RELEASE+and+Ports>

home | help