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

FreeBSD Manual Pages

  
 
  

home | help 
VIRTNETWORKD(8)		    Virtualization Support	       VIRTNETWORKD(8)

NAME
       virtnetworkd - libvirt virtual network management daemon

SYNOPSIS
       virtnetworkd [OPTION]...

DESCRIPTION
       The  virtnetworkd program is a server side daemon component of the lib-
       virt virtualization management system.

       It is one of a collection of modular daemons that replace functionality
       previously provided by the monolithic libvirtd daemon.

       This daemon runs	on virtualization hosts	to provide management for vir-
       tual networks.

       The virtnetworkd	daemon only listens for	requests on a local  Unix  do-
       main socket. Remote access via TLS/TCP and backwards compatibility with
       legacy clients expecting	libvirtd is provided by	the virtproxyd daemon.

       Restarting  virtnetworkd	does not interrupt running guests. Guests con-
       tinue to	operate	and changes in their state will	generally be picked up
       automatically during startup. None the less it is recommended to	 avoid
       restarting with running guests whenever practical.

DAEMON STARTUP MODES
       The virtnetworkd	daemon is capable of starting in two modes.

   Socket activation mode
       On  hosts  with	systemd	it is started in socket	activation mode	and it
       will rely on systemd to create and listen on the	UNIX sockets and  pass
       them  as	 pre-opened  file descriptors. In this mode most of the	socket
       related config options in /etc/libvirt/virtnetworkd.conf	will no	longer
       have any	effect.

   Traditional service mode
       On hosts	without	systemd, it will create	and listen on UNIX sockets it-
       self.

OPTIONS
       -h, --help

       Display command line help usage then exit.

       -d, --daemon

       Run as a	daemon & write PID file.

       -f, --config *FILE*

       Use this	configuration file, overriding the default value.

       -p, --pid-file *FILE*

       Use this	name for the PID file, overriding the default value.

       -t, --timeout *SECONDS*

       Exit after timeout period (in seconds), provided	there  are  no	client
       connections.

       -v, --verbose

       Enable output of	verbose	messages.

       --version

       Display version information then	exit.

SIGNALS
       On receipt of SIGHUP virtnetworkd will reload its configuration.

FILES
   When	run as root
       • /usr/local/etc/libvirt/virtnetworkd.conf

       The  default configuration file used by virtnetworkd, unless overridden
       on the command line using the -f	| --config option.

       • /var/run/libvirt/virtnetworkd-sock

       • /var/run/libvirt/virtnetworkd-sock-ro

       • /var/run/libvirt/virtnetworkd-admin-sock

       The sockets virtnetworkd	will use.

       The TLS Server private key virtnetworkd will use.

       • /var/run/virtnetworkd.pid

       The PID file to use, unless overridden by the -p	| --pid-file option.

   When	run as non-root
       • $XDG_CONFIG_HOME/libvirt/virtnetworkd.conf

       The default configuration file used by virtnetworkd, unless  overridden
       on the command line using the -f``|--config`` option.

       • $XDG_RUNTIME_DIR/libvirt/virtnetworkd-sock

       • $XDG_RUNTIME_DIR/libvirt/virtnetworkd-admin-sock

       The sockets virtnetworkd	will use.

       • $XDG_RUNTIME_DIR/libvirt/virtnetworkd.pid

       The PID file to use, unless overridden by the -p``|--pid-file`` option.

       If  $XDG_CONFIG_HOME  is	not set	in your	environment, virtnetworkd will
       use $HOME/.config

       If $XDG_RUNTIME_DIR is not set in your environment,  virtnetworkd  will
       use $HOME/.cache

EXAMPLES
       To retrieve the version of virtnetworkd:

	  # virtnetworkd --version
	  virtnetworkd (libvirt) 11.1.0

       To  start  virtnetworkd,	 instructing  it to daemonize and create a PID
       file:

	  # virtnetworkd -d
	  # ls -la /var/run/virtnetworkd.pid
	  -rw-r--r-- 1 root root 6 Jul	9 02:40	/var/run/virtnetworkd.pid

BUGS
       Please report all bugs you discover.  This should be done via either:

       1. the mailing list

	   <https://libvirt.org/contact.html>

       2. the bug tracker

	   <https://libvirt.org/bugs.html>

       Alternatively, you may report bugs to your software distributor /  ven-
       dor.

AUTHORS
       Please refer to the AUTHORS file	distributed with libvirt.

COPYRIGHT
       Copyright  (C)  2006-2020  Red Hat, Inc., and the authors listed	in the
       libvirt AUTHORS file.

LICENSE
       virtnetworkd is distributed under the terms  of	the  GNU  LGPL	v2.1+.
       This  is	free software; see the source for copying conditions. There is
       NO warranty; not	even for MERCHANTABILITY or FITNESS FOR	 A  PARTICULAR
       PURPOSE

SEE ALSO
       virsh(1), libvirtd(8),
	<https://libvirt.org/daemons.html> ,

							       VIRTNETWORKD(8)

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

home | help