Caution: This version of this document is no longer maintained. For the latest documentation, see


Mount a block special device or remote filesystem


mount [-abwruv] [-t type [-o options] [special] mountpoint]
mount [-abwruv] [-T type [-o options] special [mountpoint]]
mount [-abwruv] -e [-t|T type] [-o options] special

Runs on:



Mount all the devices listed in the /etc/fstab file (or autodetected later on). If you also specify a type, mount only those entries. This option is ignored if you specify special or mountpoint.
Prevent the lookup of the fstab file.
Enumerate the children of the special device.
-o options
Options specific to the server doing the mounting. These options include:

For more information, see Ordering mountpoints in the Process Manager chapter of the System Architecture guide.

Mount the device as read-only.
-T typespecial [mountpoint]
The special device is a string that may specify a real device or may be just a hint for the server. If mountpoint isn't specified, the server will automatically create an appropriate mountpoint.
-t type … [special] mountpoint
If the optional special string is given, the mount request goes to the server which created, or is responsible for, the special device. If this special device does not exist, the server interprets the string as a hint. If special is not given, it is passed as NULL.
Mount for update (remount).
Increase the verbosity.
Mount the device as read/write. This is the default (if the physical media permit).
Where the device is to be mounted on your system.
The name of the special device.
The type of filesystem or manager to mount:
type: Filesystem or manager:
cifs fs-cifs
etfs Embedded Transaction Filesystem (e.g. fs-etfs-ram)
io-audio io-audio
io-pkt io-pkt-v4, io-pkt-v4-hc, io-pkt-v6-hc
io-usb io-usb
nfs fs-nfs2, fs-nfs3

If you don't specify the filesystem, mount tries to determine which to use. If it can't figure out which to use, it uses qnx4.

Note: Specify io-pkt for type no matter which of io-pkt-v4, io-pkt-v4-hc, or io-pkt-v6-hc you're mounting.


Without options, mount displays the current mountpoints. With options set, this utility mounts the block special device or remote filesystem, special, as the specified mountpoint. To mount a real special device, use the -t option; to specify a special-device string (which isn't necessarily a real device), use -T.

Note: Some servers may not support all the mount options, especially with respect to remounting and enumerating.

The mount utility supports the /etc/fstab file.


Mount a QNX 4 filesystem on a hard drive as /mnt/fs:

mount -t qnx4 /dev/hd0t77 /mnt/fs

Mount a device driver for io-pkt*. In this example, is the name of the shared object that io-pkt* needs to load for the driver, not the name of a real device:

mount -T io-pkt

If you want to pass options to the driver, use the -o option before the name of the shared object:

mount -T io-pkt -o mac=12345678

Enumerate the hard disk partition table:

mount -e /dev/hd0

This will re-read the disk partition table for /dev/hd0, and create, update or delete /dev/hd0tXX block-special files for each partition. This is used in the following two scenarios:

Mount a CIFS filesystem (fs-cifs must be running first):

mount -T cifs -o abc,efg //node123: /ctest 

Where your name is abc, your password is efg, your CIFS server is node123 with an IP address of, the share you want to mount is /C, and the mountpoint you want to use is /ctest.

Mount an NFS 2 client filesystem (fs-nfs2 must be running first):

mount -T nfs /mnt/home

Mount an NFS 3 client filesystem (fs-nfs3 must be running first):

mount -T nfs -o ver3 server_node:/qnx_bin /bin

Mount the Qnet network protocol:

mount -T io-pkt /lib/dll/

Display the current mountpoints:


Mount the shared object that supports Enhanced Host Controller Interface (EHCI) USB controllers:

mount -T io-usb /dev/io-usb/io-usb

See also:

devb-*,, fs-cifs,,, fs-nfs2, fs-nfs3,,, /etc/fstab, io-audio,, io-pkt*, io-usb, umount

mount(), mount_parse_generic_args() in the QNX Neutrino Library Reference

Filesystems chapter of the System Architecture guide

Working with Filesystems chapter, and Filesystems and block I/O (devb-*) drivers in the Fine-Tuning Your System chapter of the QNX Neutrino User's Guide