*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> standard/getmountid (2)              


getmountid(2)							 getmountid(2)

NAME    [Toc]    [Back]

     getmountid	- get filesystem mount identifier

SYNOPSIS    [Toc]    [Back]

     #include <sys/mount.h>

     int getmountid (const char	*path, mountid_t *buf);

DESCRIPTION    [Toc]    [Back]

     getmountid	returns	an identifier for the filesystem containing the	file
     named by path.  Read, write, or execute permission	for the	named file is
     not required, but all directories listed in the path name leading to the
     file must be searchable.  buf is a	pointer	to a mountid structure that is
     filled by the system call.

     The identifier returned is	guaranteed to be unique	for the	mounted
     filesystem	within the running system, except for autofs's lofs
     filesystems. The identifier is not	guaranteed to be unique	across
     systems, and it is	not guaranteed to persist across reboots or even
     across mounts of the given	filesystem. The	identifier returned by lofs
     filesystems is that of the	mounted	filesystem that	lofs is	providing
     access to via a loopback mount. Therefore,	for lofs filesystems the
     combination of getmountid and lstat's st_rdev must	be used	to identify

     getmountid	fails if one or	more of	the following are true:

     EACCES	    Search permission is denied	on a component of the path

     EFAULT	    path or buf	points outside the process's allocated address

     EINTR	    A signal was caught	during getmountid execution.

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

     ELOOP	    Too	many symbolic links were encountered in	translating

     ENAMETOOLONG   The	length of a path component exceeds {NAME_MAX}
		    characters,	or the length of path exceeds {PATH_MAX}

     ENOENT	    Either a component of the path prefix or the file referred
		    to by path does not	exist.

     ENOLINK	    path points	to a remote machine and	the link to that
		    machine is no longer active.

									Page 1

getmountid(2)							 getmountid(2)

     ENOTDIR	    A component	of the path prefix of path is not a directory.

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion	a value	of 0 is	returned.  Otherwise, a	value
     of	-1 is returned and errno is set	to indicate the	error.

SEE ALSO    [Toc]    [Back]


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
fstyp IRIX determine filesystem identifier
mount_xfs OpenBSD mount the xfs filesystem
nsmount IRIX mount name service filesystem
mount_cd9660 OpenBSD mount an ISO-9660 filesystem
sgi_eag_mount IRIX mount a filesystem with attributes
mount OpenBSD mount or dismount a filesystem
mntproc IRIX mount the /proc filesystem
unmount OpenBSD mount or dismount a filesystem
vfs_getvfs FreeBSD returns a mount point given its file system identifier
exports Tru64 Defines remote mount points for NFS mount requests
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service