vfs_getvfs (9)

Leading comments

Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice(s), this list of conditions and the following disclaimer as
   the first lines of this file unmodified other than the possible
   addition of one or more copyright notices.
2. Redistributions in binary for...

(The comments found at the beginning of the groff file "man9/vfs_getvfs.9freebsd".)

NAME

vfs_getvfs - returns a mount point given its file system identifier

SYNOPSIS

In sys/param.h In sys/mount.h Ft struct mount * Fn vfs_getvfs fsid_t *fsid

DESCRIPTION

The Fn vfs_getvfs function returns the mount point structure for a file system given its file system identifier. The file system ID should have been allocated by calling vfs_getnewfsid9; otherwise, it will not be found.

A major user of Fn vfs_getvfs is NFS, which uses the Vt fsid as part of file handles in order to determine the file system a given RPC is for. If Fn vfs_getvfs fails to find the mount point related to Fa fsid , the file system is considered stale.

RETURN VALUES

If Fa fsid is found, the mount point for the ID is returned; otherwise, NULL is returned.

PSEUDOCODE

if ((mp = vfs_getvfs(&fhp->fh_fsid)) == NULL) {
        error = ESTALE;
        goto out;
}

SEE ALSO

vfs_getnewfsid9

AUTHORS

This manual page was written by An Chad David Aq davidc@acns.ab.ca .