nbdfuse(1) LIBNBD nbdfuse(1) (NAME) nbdfuse - (SYNOPSIS) nbdfuse [-C N|--connections N] [-d] [-o FUSE-OPTION] [-P PIDFILE] [-r] [-s] [-v|--verbose] MOUNTPOINT[/FILENAME] URI nbdfuse MOUNTPOINT[/FILENAME] [ CMD [ARGS ...] ] nbdfuse MOUNTPOINT[/FILENAME] --command CMD [ARGS ...] nbdfuse MOUNTPOINT[/FILENAME] --fd N nbdfuse MOUNTPOINT[/FILENAME] --tcp HOST PORT nbdfuse MOUNTPOINT[/FILENAME] --unix SOCKET nbdfuse MOUNTPOINT[/FILENAME] --vsock CID PORT : fusermount3 -u MOUNTPOINT : nbdfuse --help nbdfuse --fuse-help nbdfuse -V|--version nbdfuse (mount) Network Block Device (NBD) . NBD MOUNTPOINT/FILENAME ( MOUNTPOINT/nbd) . NBD . nbdfuse . MOUNTPOINT <<>> (naked) ( ). NBD . NBD URI ( "nbd://localhost") NBD (subprocess) nbdfuse ( "[ ... ]") ( "MODES" ). (unmount) "fusermount3 -u MOUNTPOINT" . (EXAMPLES) NBD NBD "example.com" NBD ( ) : $ mkdir dir $ nbdfuse dir nbd://example.com & $ ls -l dir/ total 0 -rw-rw-rw-. 1 nbd nbd 1073741824 Jan 1 10:10 nbd dir/nbd . NBD . : $ fusermount3 -u dir $ rmdir dir nbdkit RAM disk "[ ... ]" NBD . nbdkit(1) RAM disk : $ mkdir dir $ nbdfuse dir/ramdisk [ nbdkit --exit-with-parent memory 1G ] & $ ls -l dir/ total 0 -rw-rw-rw-. 1 nbd nbd 1073741824 Jan 1 10:10 ramdisk $ dd if=/dev/urandom bs=1M count=100 of=mp/ramdisk conv=notrunc,nocreat 100+0 records in 100+0 records out 104857600 bytes (105 MB, 100 MiB) copied, 2.08319 s, 50.3 MB/s RAM disk nbdkit RAM disk : $ fusermount3 -u dir $ rmdir dir qemu-nbd qcow2 qemu-nbd(8) qemu : $ mkdir dir $ nbdfuse dir/file.raw [ qemu-nbd -f qcow2 file.qcow2 ] & $ ls -l dir/ total 0 -rw-rw-rw-. 1 nbd nbd 1073741824 Jan 1 10:10 file.raw dir/file.raw raw file.qcow2 . dir/file.raw qcow2 . : $ fusermount3 -u dir $ rmdir dir nbdkit(1) : $ mkdir dir $ nbdfuse dir/disk.iso \ [ nbdkit --exit-with-parent \ curl --filter=xz \ http://builder.libguestfs.org/fedora-30.xz ] & $ ls -l dir/ total 0 -rw-rw-rw-. 1 nbd nbd 6442450944 Jan 1 10:10 disk.iso $ file dir/disk.iso dir/disk.iso: DOS/MBR boot sector $ qemu-system-x86_64 -m 4G \ -drive file=dir/disk.iso,format=raw,if=virtio,snapshot=on $ fusermount3 -u dir qemu qemu NBD . (OPTIONS) --help . -C N --connections N multi-conn N . 4 . multi-conn . --command multi-conn . --fd multi-conn . multi-conn ( nbdinfo(1) ). "THREAD MODEL" . -C 1 --connections 1 multi-conn. NBD . "THREAD MODEL" . --fuse-help FUSE . -o . -o FUSE-OPTION FUSE. FUSE --fuse-help . FUSE: -o allow_other . /etc/fuse.conf . -o kernel_cache ( API libnbd(3) ). . -o uid=N -o gid=N UID GID . -P PIDFILE --pidfile PIDFILE nbdfuse (PID) nbdfuse PIDFILE . nbdfuse . nbdfuse (kill) . "fusermount3 -u" nbdfuse . -r --readonly . . NBD . ( "is_read_only:" nbdinfo(1) ). -s FUSE. "THREAD MODEL" . -v --verbose -d (verbose) stderr. libnbd . -d FUSE . -V --version ..SH " (MODES)" NBD . : nbdfuse MOUNTPOINT URI URI NBD ( nbd_connect_uri(3) https://github.com/NetworkBlockDevice/nbd/blob/master/doc/uri.md). TLS "example.com" 10809 "disk" : nbdfuse dir nbds://example.com/disk nbdfuse MOUNTPOINT [ CMD [ARGS ...] ] NBD (subprocess). NBD nbdfuse . NBD systemd . << (EXAMPLES)>> nbd_connect_systemd_socket_activation(3) . nbdfuse MOUNTPOINT --command CMD [ARGS ...] . NBD nbdfuse stdin/stdout . "nbdkit -s" . nbd_connect_command(3) . nbdfuse MOUNTPOINT --fd N (file descriptor). nbdfuse . nbdfuse . nbd_connect_socket(3) . nbdfuse MOUNTPOINT --tcp HOST PORT TCP. NBD TCP . nbd_connect_tcp(3) . nbdfuse MOUNTPOINT --unix SOCKET . NBD (Unix domain socket). nbd_connect_unix(3) . nbdfuse MOUNTPOINT --vsock CID PORT vsock. NBD "AF_VSOCK". nbd_connect_vsock(3) . (THREAD MODEL) nbdfuse . . nbdfuse (multithreaded) . nbdfuse NBD ( <> ). . multi-conn : o "[ CMD ... ]" --command --fd o -C 1 o multi-conn NBD ( nbdinfo(1) ) -C . nbdfuse NBD ( << >> <> ). FUSE fuse.ko . FUSE FUSE FUSE . FUSE ( trim) (= ) . . -s FUSE . (NOTES) (Loop mounting) ( ) (loop mount) . (deadlock) . nbd-client(8) qemu-nbd(8) libguestfs(3) guestfish(1) guestmount(1) NBD ..SS " NBD" NBD ( ) libnbd(3) . NBD nbdsh(1) . NBD nbdcopy(1) . (COMPARISON TO OTHER TOOLS) "nbd-client" nbd-client(8) ( NBD /dev/nbdX ) : o nbd-client o nbd-client (root) nbdfuse o nbdfuse (mount) o nbdfuse libnbd NBD o nbdfuse FUSE "qemu-nbd" qemu-nbd(8) /dev/nbdX . nbdfuse . (SEE ALSO) libnbd(3), nbdcopy(1), nbddiscard(1), nbddump(1), nbdinfo(1), nbdsh(1), nbdublk(1), nbdzero(1), fusermount3(1), mount.fuse3(8), nbd_connect_uri(3), nbd_connect_command(3), nbd_connect_socket(3), nbd_connect_systemd_socket_activation(3), nbd_connect_tcp(3), nbd_connect_unix(3), nbd_connect_vsock(3), libguestfs(3), guestfish(1), guestmount(1), nbdkit(1), nbdkit-loop(1), qemu-nbd(8), nbd-client(8). (AUTHORS) Richard W.M. Jones (COPYRIGHT) Copyright Red Hat (LICENSE) << >> (GNU Lesser General Public License) ( ) / . . << >> . << >> : Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA libnbd-1.24.3 2026-07-16 nbdfuse(1)