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

FreeBSD Manual Pages

  
 
  

home | help
BMD(8)			    System Manager's Manual			BMD(8)

NAME
       bmd -- bhyve management daemon

SYNOPSIS
       bmd   [-F]   [-f	  config_file]	[-P  pid_file]	[-p  plugin_directory]
	   [-m unix_domain_socket_permission] [-v]

DESCRIPTION
       The bmd utility spawns bhyve processes according	to  the	 configuration
       file,  and  waits  for them to terminate. If a bhyve process terminates
       with exit code 0	(rebooted), bmd	spawns the bhyve  process  again.  The
       bmd  receives control commands from bmdctl(8) to	manage bhyve processes
       via unix	domain socket. See bmdctl(8) for detail.

OPTIONS
       -F      Run in foreground.

       -f config_file
	       Specify the pathname of an alternate configuration  file.   The
	       default is /usr/local/etc/bmd.conf.

       -P pid_file
	       Specify	an  alternative	file in	which to store the process ID.
	       The default is /var/run/bmd.pid.

       -p plugin_directory
	       Specify the directory path of an	alternate plugin  store.   The
	       default is /usr/local/libexec/bmd.

       -m unix_domain_socket_permission
	       Specify the unix	domain socket permission in octal number.  The
	       default	is 0660.  Please note that the unix domain socket path
	       cannot be changed in command line options. See  bmd.conf(5)  to
	       change the path.

       -v      Show version number.

       The  bmd	 waits	for  control  commands	from bmdctl(8) via unix	domain
       socket. When bmd	receives a boot	request	from  bmdctl(8),  bmd  reloads
       the configuration file to check updates for boot	target.	If any updates
       are found, the bmd adopts the updated configuration.

LOGGING
       bmd  writes  log	messages to LOG_DAEMON facility. Usually it is written
       in the '/var/log/daemon.log' file by the	syslogd(8).  You can see error
       messages	of BMD and informational messages such as  starting  a	VM  or
       stopping	a VM with or without an	error.

SIGNAL HANDLING
       bmd deals with the following signals:

       SIGTERM	Send  SIGTERM to all bhyve processes and wait for them to ter-
		minate,	then quit the daemon.
       SIGHUP	Reload the configuration file.

PLUGINS
       bmd loads plugins on start up. Plugins extend the functionality of bmd.
       And also	add configuration parameters  for  extended  functionality  if
       necessary.

FILES
       /var/run/bmd.pid		 Pid file
       /var/run/bmd.sock	 Unix domain socket
       /usr/local/etc/bmd.conf	 Configuration file
       /usr/local/libexec/bmd	 Plugin	directory
       /usr/local/var/cache/bmd	 Storage for UEFI variables

SEE ALSO
       bmdctl(8), bmd.conf(5)

FreeBSD	Ports 14.quarterly	  Apr 2, 2024				BMD(8)

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

home | help