Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ mount(2) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                 mount(2)



        _________________________________________________________________
        mount                                                 System Call
        Mount a file system.
        _________________________________________________________________


        SYNTAX

        #include <sys/mount.h>

        int   mount  (special, directory, flag)
        char *          special;
        char *          directory;
        int             flag;


        PARAMETERS

        special        Address of a pathname of a block special file.


        directory      Address of a pathname of a directory.


        flag           Indicates 'read-only' or 'read-write' file system
                       device.


        DESCRIPTION

        Mount adds the file system device identified by <special> to the
        set of active file system devices, using the directory identified
        by <directory> as the mount point, with the following
        consequences:

        *    The filename store contained on <special> is added to the
             system filename store.  Thus, all files contained on
             <special> can be named.

        *    References to the mount point will refer to the root
             directory on the mounted file system device.

        *    The original sub-tree under the mount point disappears from
             the system filename store.  However, the files in that
             subtree remain unchanged.  These files still exist, but can
             no longer be named.

        *    The low-order bit of <flag> controls write permission on the
             mounted file system device; if 1, writing is forbidden,
             otherwise writing is permitted according to individual file
             accessibility.



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                 mount(2)



        If an error occurs, no changes are made.


        ACCESS CONTROL

        The effective user id of the calling process must be superuser.


        RETURN VALUE

        0              Completed successfully.


        -1             An error occurred.  Errno is set to indicate the
                       error.


        EXCEPTIONS

        Errno may be set to one of the following error codes:


        EBUSY          <Directory> is being used by another mount, is
                       someone's current working directory or is
                       otherwise open for access.


        EBUSY          The device associated with <special> is currently
                       mounted.


        EBUSY          The system limit on mounted devices has been
                       reached.


        EINVAL         System information on the file system is bad.


        ENOSPC         Not enough memory was available to read system
                       information from the file system.


        EIO            An I/O error occurred while reading system
                       information from the file system.


        ENOTBLK        <Special> is not a block special device.


        ENOTDIR        <Directory> is not a directory.




        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)





                                                                 mount(2)



        ENXIO          The device associated with <special> does not
                       exist.


        EPERM          Permission to mount a file system device is denied
                       to the calling process.


        EROFS          <Directory> resides on a read-only file system.


        ENOENT         Either <special> or <directory> do not exist.


        ENOENT         A non-terminal component of either <special> or
                       directory does not exist.


        ENOTDIR        A non-terminal component of either <special> or
                       <directory> was not a directory or symbolic link.


        ENAMETOOLONG   Either <special> or <directory> exceeds the length
                       limit for pathnames.


        ENAMETOOLONG   A component of either <special> or <directory>
                       exceeds the length limit for filenames.


        ENOMEM         There are not enough system resources to resolve
                       either <special> or <directory> or to expand a
                       symbolic link.


        ELOOP          The number of symbolic links encountered while
                       resolving either <special> or <directory> exceeded
                       MAXSYMLINKS.  A symbolic link cycle is suspected.


        EPERM          Either <special> or <directory> contains a
                       character not in the allowed character set.


        EFAULT         Either <special> or <directory> does not
                       completely reside in the process's address space
                       or either <special> or <directory> does not
                       terminate in the process's address space.

        SEE ALSO




        DG/UX 4.00                                                 Page 3
               Licensed material--property of copyright holder(s)





                                                                 mount(2)



        The related manual sections:  umount(2),  nfsmount(2).





















































        DG/UX 4.00                                                 Page 4
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026