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

FreeBSD Manual Pages

  
 
  

home | help
WEBCAMD(8)		     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  web-
     cam,  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  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 devi-
	     cename 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.

     -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 communica-
	     tion.  NOTE: If you want to start multiple vTuner	clients  in  the
	     background by use of the -B option, you need to supply a unique in-
	     terface 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 num-
	     ber  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 communi-
	     cation.

EXAMPLES
     With the USB device connected, determine the [ugen]<unit>.<addr> values us-
     ing 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 			  July 28, 2021 		      WEBCAMD(8)

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

home | help