OnWorks favicon

xnbd-client - Online in the Cloud

Run xnbd-client in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command xnbd-client that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



xnbd-client - Connect to a server running xnbd-server(8), to use its exported block device


xnbd-client [OPTIONS] [bs=SIZE] [timeout=SECONDS] HOST PORT NBD-DEVICE

xnbd-client [OPTIONS] --connect NBD-DEVICE HOST PORT [HOST PORT ..]

xnbd-client --disconnect NBD-DEVICE

xnbd-client --check NBD-DEVICE

xnbd-client [OPTIONS] --getsize64 HOST PORT [HOST PORT ..]


With xnbd-client, you can connect to a server running xnbd-server or xnbd-wrapper, thus
using raw diskspace from that server as a block device on the local client.

To do this, support from the Linux Kernel is necessary, in the form of the Network Block
Device (NBD). When you have that, either in the kernel, or as a module, you can connect to
an NBD server and use its exported file through a block special file with major mode 43.

Long options can also be specified with two leading dashes. Some options are
call-compatible to nbd-client(1) as are most behavioural switches. This makes xnbd-client
a plug-in replacement for nbd-client.


The following options are supported:

--blocksize SIZE
Use the provided value as block size. Default is 1024; allowed values are either 512,
1024, 2048 or 4096. For best results use a block size value of 4096.

For compatibility to nbd-client(1) you can also use bs=SIZE.

Check whether the specified nbd device is connected.

If the device is connected, xnbd-client will exit with an exit state of 0 and print
the PID of the xnbd-client instance that connected it to stdout.

If the device exists but is not connected (i.e. is free for use), xnbd-client will
exit with code 2 and not print anything on stdout.

If the device does not exist (for example because the nbd module was not loaded) or if
an error occurred, xnbd-client will exit with a positive return code other than 2 and
not print anything on stdout, either.

Connect to the nbd-server

Disconnect the specified nbd device from the server. Terminates execution with an exit
state of 0 on success.

Report remote disk size in bytes, mimicking blockdev(8).

--exportname NAME
If the server supports to access devices by an identifier, use NAME to request access
to a particular volume. This command is useful in combination with an xnbd-wrapper and
only succeeds, if the remote host is exporting the requested device.

--retry COUNT
Try up to "COUNT" times to connect to the associated nbd-server. Default is 1, that is
xnbd-client will stop after the first unsuccessful try.

--recovery-command COMMAND
Invoke the specified command on unexpected disconnection

--recovery-command-reboot: Invoke the reboot(8) command on unexpected disconnection

--timeout SECONDS
Use a timeout period (default is 0 which means not to use a timeout). Please do not
use this option for now, as it seems not to work due to a bug in the kernel module.

For compatibility to nbd-client(1) you can also use timeout=SECONDS


The following positional options are supported:

The site to connect to a remote xnbd-server. You can specify any resolvable hostname,
IPv4 or IPv6 address.

The port number to connect to on remote side

The local nbd-device to be associated with the remote xnbd-server.

You can specify multiple host port tuples. xnbd-client will try to connect to each of them
in order until it succeeds to establish a connection to a server.

Use xnbd-client online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    fre:ac - free audio converter
    fre:ac - free audio converter
    fre:ac is a free audio converter and CD
    ripper for various formats and encoders.
    It features MP3, MP4/M4A, WMA, Ogg
    Vorbis, FLAC, AAC, and Bonk format
    support, ...
    Download fre:ac - free audio converter
  • 2
    Matplotlib is a comprehensive library
    for creating static, animated, and
    interactive visualizations in Python.
    Matplotlib makes easy things easy and
    hard thing...
    Download Matplotlib
  • 3
    Write your chatbot logic once and
    connect it to one of the available
    messaging services, including Amazon
    Alexa, Facebook Messenger, Slack,
    Telegram or even yo...
    Download BotMan
  • 4
    Joplin is a free and open source
    note-taking and to-do application that
    can handle a large number of notes in
    Markdown format, organize them into
    notebooks and...
    Download Joplin
  • 5
    gerbv  a Gerber (RS-274X) viewer
    gerbv � a Gerber (RS-274X) viewer
    Gerbv is an open source Gerber file
    (RS-274X only) viewer. Gerbv lets you
    load several files on top of each other,
    do measurements on the displayed image,
    etc. ...
    Download gerbv � a Gerber (RS-274X) viewer
  • 6
    I/O performance Analysis Tool.
    Audience: Developers, Information
    Technology, Science/Research, System
    Administrators. User interface: Win32
    (MS Windows). Progr...
    Download Iometer
  • More »

Linux commands