Manpages

NAME

enbd.conf − configuration file for NBD devices

DESCRIPTION

/etc/enbd.conf is the default configuration file for the NBD system init files and state daemons. It defines how NBD devices are configured on a system.

FORMAT

/etc/enbd.conf is composed of several lines, one for each module, client or server daemon being configured. Lines beginning with a hash symbol "#" and empty lines are discarded during the scan. Lines that have effect begin with one of the keywords module or client or server.

The order of items in the file is unimportant.

Here’s a sample enbd.conf configuration file:

#
# sample enbd.conf configuration file

# First, a module specificiation line. It consists of options
# to be passed to the module by insmod. The identifier is
# not currently used but will eventually be used in the -o
# option to insmod:
#
# KEY ID OPTIONS ...
module 0 merge_requests=0 sync_intvl=0 rahead=20 show_errs=1

# Now a client running device /dev/nda identifying itself as
# instance 0 from this machines IP address and connecting to
# machine karajan on port 1034 using 4 channel communication:
#
# KEY ID DEVICE SERVER PORT OPTIONS ...
client 0 /dev/nda karajan 1034 -n 4

# And finally a server identifying itself as instance 0 on this
# machines IP address and running on port 1033 with resource
# the raw partition /dev/hdb1
#
# KEY ID PORT RESOURCES OPTIONS ...
server 0 1033 /dev/hdb1

Here is more information on the directives in an enbd configuration file.

client

This introduces the configuration line for an enbd-client daemon.

DEVICE

The nbd device controlled by an enbd-client daemon.

ID

This value is passed to the server or client with −i. It serves as the primary key in the database represented by enbd.conf and forms part of the name of the file containing the PID in /var/run/nbd-{server,client}-ID.pid.

module

This introduces the configuration line for an nbd module.

PORT

The port on the server machine to which an enbd-client daemon should connect, or the port on the local machine on which an enbd-server daemon should listen for connections.

OPTIONS

Other options to be passed to a module or daemon; the components are separated by whitespace, as they would appear naturally on the command line.

RESOURCE

The list of local resources exported by an enbd-client daemon, separated by commas, without whitespace.

server

This introduces the configuration line for an enbd-server daemon.

SERVER

The server machine name or IP address to which an enbd-client daemon should connect.

SEE ALSO

enbd-client(8), enbd-server(8).