mount

Updated: May 06, 2022

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 [-f]

Runs on:

QNX 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.
-f
(QNX Neutrino 7.1 or later) Display the mount flags and options.
-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 Pathname Management in the Process Manager chapter of the System Architecture guide.

  • trusted — Mount the device or filesystem as trusted. Used only when you mount a device that provides integrity protection to the underlying filesystem (e.g., QTD) or the filesystem this type of device protects.

    For more information, see Pathtrust in the System Security Guide.

  • nosuid — Ignore setuid bits on the filesystem.
  • mntgid=numeric_gid — (QNX Neutrino 6.6 or later) Specify the group ID to use for the mountpoint.
  • mntperms=octal_permissions — (QNX Neutrino 6.6 or later) Specify the permissions to use for the mountpoint. For more information about octal permission values, see the entry for chmod.
  • mntuid=numeric_uid — (QNX Neutrino 6.6 or later) Specify the user ID to use for the mountpoint.

    Any of the mnt* options given to a specific mount command override those provided on the devb-* driver command line. For an example, see the mntuid description in the io-blk.so entry.

-r
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 doesn't exist, the server interprets the string as a hint. If special isn't 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:
cifs fs-cifs
dos fs-dos.so
etfs Embedded Transaction Filesystem (e.g., fs-etfs-ram)
ext2 fs-ext2.so
ifs Image filesystem (see mkifs)
io-audio io-audio
io-pkt io-pkt-v4-hc, io-pkt-v6-hc (see the note below)
mac fs-mac.so
nfs fs-nfs3
nt fs-nt.so
qnx6 Power-Safe filesystem (see fs-qnx6.so)
qtd QNX Trusted Disk (see fs-qtd.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 qnx6.

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

If you've started more than one instance of io-pkt, and you've used the -i option to specify a stack instance number, you can include the stack number in the type argument (e.g., mount -Tio-pkt2 ...). For more information, see Running multiple instances of the TCP/IP stack in the TCP/IP Networking chapter of the QNX Neutrino User's Guide.

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.

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.

In order to use this utility, your process needs to have the vfs/mount-blk (BLK_ABILITY_MOUNTVFS) custom ability enabled. For more information, see procmgr_ability() and procmgr_ability_lookup() in the C Library Reference.

CAUTION:
When mounting a filesystem using devb-*, you can't access any file on the same devb-* process. This is because it becomes single threaded when performing the mount operation.

Examples:

Mount a Power-Safe filesystem on a hard drive as /mnt/fs:

mount -t qnx6 /dev/hd0t177 /mnt/fs

Mount a device driver for io-pkt*. In this example, devnp-asix.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 devnp-asix.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 devnp-asix.so

Enumerate the hard disk partition table:

mount -e /dev/hd0

This will reread 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: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 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

Remount the filesystem that's currently mounted at / as read-only:

mount -ur /

Remount the filesystem that's currently mounted at / as read-write:

mount -uw /

Remount the filesystem, adding the noatime option.

mount -u -o noatime /