Fsys

Filesystem manager (QNX)

Syntax:

Fsys [options] &

Options:

-a
Perform all system writes (inodes, bitmap, etc.) asynchronously.
-A
Don't update access times if nothing else about the file (mode, owner, data etc.) changed. If this option is used, the filesystem will not be behaving in the manner required by POSIX. Utilities and scripts which rely on time of last access will not behave as would be expected on a POSIX system. The advantage of -A is that it is slightly faster on a heavily loaded server.
-C num_names
Number of pathname components to cache. The default is 1.5x the number of in-memory inodes (specified by -i).
-c cache_size[M|m|k|b]
The size of the cache. Units are assumed to be 1k unless the units are specified as follows:
Char Unit
M or mmegabytes
k kbytes
b 512-byte blocks
The default cache size is 1/8 of the total memory.
-d delay
The write-behind ("hold-off") delay applied to asynchronous writes, specified in seconds (default is 2). If the asynchronous write queue is empty, this delay is applied when the first block is placed in the queue. As a result, the queue is likely to contain many blocks before the driver is called to drain the queue.
-f ocb
The maximum number of open control blocks that may be open at one time in the filesystem (default is equal to the number of processes).
-i inode_table_size
The maximum number of distinct files that may be open at any time (default is twice the number of processes).
-l lock_table_size
("el") The number of locks that can be simultaneously outstanding (default is equal to the number of processes Proc has been configured for. See "Proc -pprocs").
-O
Process requests in time order, not priority order.
-P percentage
Reserve this percentage of the cache for segmented LRU replacement. Default is 20% if the cache size is the default or larger. If the cache specified is smaller than the default cache, the reserved percentage is decreased. -P0 effectively results in pure LRU caching.
-r ramdisk_size
The size of an optional ramdisk, in units of 1K. The minimum size is 4K; the maximum size is limited by available memory. There is no default size. A block special file called /dev/ram is created.
-t threads
The number of threads (default is 4, minimum is 1)
-T
Disable threaded operation in driver.
-v level
The verbosity level (default is 1; 0 disables verbosity).

Examples:

Start the filesystem manager with default settings:

    Fsys &

Description:

The Filesystem Manager (Fsys) provides a standardized means of storing and accessing data on disk subsystems. Fsys is responsible for handling all requests to open, close, read, and write to files.

The Fsys manager lets you define ramdisks. A ramdisk is a block of memory that's accessed by the filesystem as if it were a disk drive. It can be effectively used for temporary files or to augment the cache by storing frequently used data, such as programs or tables. Only one ramdisk is supported by each Filesystem Manager process. The ramdisk is defined as a block special file with the name /dev/ram. To define the root name for the filesystem on the ramdisk, you use the mount utility.

Note that since a ramdisk is entirely RAM-based, its contents are lost when the system is rebooted.

The maximum number of distinct files that may be open at any time may be less than the total number of open files, since files with links have only one entry and the same file opened by several processes at the same time has only one entry.

Exit status:

Fsys normally will not terminate. However, it is possible for it to exit if it encounters errors on startup.

1
Not being run by root or failed to allocate internal process table (memory)
2
Failed to allocate thread space (memory)
3
Failed to allocate cache (memory)
4
Failed to allocate file descriptions (memory)
5
Failed to allocate inodes (memory)
7
Failed to allocate lock table (memory)
8
Failed to allocate ramdisk (memory)
9
Failed during init_fd()
10
Failed to attach name
11
Failed to obtain driver proxy
12
Failed to obtain timer proxy
13
Failed to create timer
14
Failed to obtain major device number
15
Failed to allocate (reserve) heap (memory)

Files:

Fsys closes its standard input, standard output and standard error after initialization has been completed. Error messages during initialization will be written to standard error, except for the case where Fsys is not being run by root, in which a message is written to standard output.

Fsys adopts block-special files under /dev and adopts other files under the filesystem mount points specified to the mount utility.

See also:

Caveats:

Although the -a option may speed up certain operations, its use, especially with a large delay (option -d), can seriously affect the reliability of the filesystem in the event of an unplanned shutdown, such as a power failure. You should use the -a option with extreme caution only after experimentation has shown that its use is necessary and only on a reliable system (possibly equipped with a UPS — uninterruptible power supply).