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  de-
	     fault 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  de-
	     fault is /usr/local/libexec/bmd.

     -m unix_domain_socket_permission
	     Specify the unix domain socket permission in octal number.  The de-
	     fault 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 configura-
     tion  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 mes-
     sages 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  termi-
	      nate, 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  neces-
     sary.

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 15.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+15.1.quarterly>

home | help