mount

Mount a block special device or remote filesystem

Syntax:

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
      [mountpoint]
mount

Runs on:

Neutrino

Options:

-a

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.

-b

Prevent the lookup of the fstab file.

-e

Enumerate the children of the special device.

-o options

Options specific to the server doing the mounting. These options include:

• before — Mount the filesystem so that it's resolved before any other filesystems mounted at the same pathname (in other words, it's placed in front of any existing mount). When you access a file, the system looks on this filesystem first.
• after — Mount the filesystem so that it's resolved after any other filesystems mounted at the same pathname (in other words, it's placed behind any existing mount). When you access a file, the system looks on this filesystem last, and only if the file wasn't found on any other filesystems.

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

-r

Mount the device as read-only.

-T type … special [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.

-u

Mount for update (remount).

-v

Increase the verbosity.

-w

Mount the device as read/write. This is the default (if the physical media permit).

mountpoint

Where the device is to be mounted on your system.

special

The name of the special device.

type

The type of filesystem or manager to mount:

type:	Filesystem or manager:
cd	fs-cd.so
cifs	fs-cifs
dos	fs-dos.so
etfs	Embedded Transaction Filesystem (e.g. fs-etfs-ram)
ext2	fs-ext2.so
io-audio	io-audio
io-pkt	io-pkt-v4, io-pkt-v4-hc, io-pkt-v6-hc
io-usb	io-usb
mac	fs-mac.so
nfs	fs-nfs2, fs-nfs3
nt	fs-nt.so
qnx4	fs-qnx4.so
qnx6	fs-qnx6.so
udf	fs-udf.so

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.

---

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

---

Description:

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.

---

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

---

The mount utility supports the /etc/fstab file.

Examples:

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, devn-ne2000.so 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 devn-ne2000.so

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 devn-ne2000.so

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:

• when the disk driver is used without any automatic enumeration (blk auto=none), or
• when the partition table has been modified (for example, with fdisk).

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

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

Where your name is abc, your password is efg, your CIFS server is node123 with an IP address of 1.1.1.1, 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 10.1.0.22:/home /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/lsm-qnet.so

Display the current mountpoints:

mount

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

mount -T io-usb devu-ehci.so /dev/io-usb/io-usb

See also:

devb-*, fs-cd.so, fs-cifs, fs-dos.so, fs-ext2.so, fs-nfs2, fs-nfs3, fs-qnx4.so, fs-qnx6.so, /etc/fstab, io-audio, io-blk.so, 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