1ffc0b97fSAlfred Perlstein.\" 2ffc0b97fSAlfred Perlstein.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved. 3ffc0b97fSAlfred Perlstein.\" 4ffc0b97fSAlfred Perlstein.\" Redistribution and use in source and binary forms, with or without 5ffc0b97fSAlfred Perlstein.\" modification, are permitted provided that the following conditions 6ffc0b97fSAlfred Perlstein.\" are met: 7ffc0b97fSAlfred Perlstein.\" 1. Redistributions of source code must retain the above copyright 8ffc0b97fSAlfred Perlstein.\" notice(s), this list of conditions and the following disclaimer as 9ffc0b97fSAlfred Perlstein.\" the first lines of this file unmodified other than the possible 10ffc0b97fSAlfred Perlstein.\" addition of one or more copyright notices. 11ffc0b97fSAlfred Perlstein.\" 2. Redistributions in binary form must reproduce the above copyright 12ffc0b97fSAlfred Perlstein.\" notice(s), this list of conditions and the following disclaimer in the 13ffc0b97fSAlfred Perlstein.\" documentation and/or other materials provided with the distribution. 14ffc0b97fSAlfred Perlstein.\" 15ffc0b97fSAlfred Perlstein.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY 16ffc0b97fSAlfred Perlstein.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 17ffc0b97fSAlfred Perlstein.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 18ffc0b97fSAlfred Perlstein.\" DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY 19ffc0b97fSAlfred Perlstein.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 20ffc0b97fSAlfred Perlstein.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 21ffc0b97fSAlfred Perlstein.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 22ffc0b97fSAlfred Perlstein.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23ffc0b97fSAlfred Perlstein.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24ffc0b97fSAlfred Perlstein.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 25ffc0b97fSAlfred Perlstein.\" DAMAGE. 26ffc0b97fSAlfred Perlstein.\" 27ffc0b97fSAlfred Perlstein.\" $FreeBSD$ 28ffc0b97fSAlfred Perlstein.\" 29ffc0b97fSAlfred Perlstein.Dd November 21, 2001 30ffc0b97fSAlfred Perlstein.Dt VFS_GETVFS 9 31ffc0b97fSAlfred Perlstein.Os 32ffc0b97fSAlfred Perlstein.Sh NAME 33ffc0b97fSAlfred Perlstein.Nm vfs_getvfs 341f620c2eSRuslan Ermilov.Nd "returns a mount point given its filesystem identifier" 35ffc0b97fSAlfred Perlstein.Sh SYNOPSIS 36ffc0b97fSAlfred Perlstein.In sys/param.h 37ffc0b97fSAlfred Perlstein.In sys/mount.h 381f620c2eSRuslan Ermilov.Ft "struct mount *" 39ffc0b97fSAlfred Perlstein.Fn vfs_getvfs "fsid_t *fsid" 40ffc0b97fSAlfred Perlstein.Sh DESCRIPTION 41ffc0b97fSAlfred PerlsteinThe 42ffc0b97fSAlfred Perlstein.Fn vfs_getvfs 43ffc0b97fSAlfred Perlsteinfunction returns the mount point structure for a filesystem given its filesystem 441f620c2eSRuslan Ermilovidentifier. 451f620c2eSRuslan ErmilovThe filesystem ID should have been allocated by calling 461f620c2eSRuslan Ermilov.Xr vfs_getnewfsid 9 ; 47ffc0b97fSAlfred Perlsteinotherwise, it will not be found. 48ffc0b97fSAlfred Perlstein.Pp 49ffc0b97fSAlfred PerlsteinA major user of 50ffc0b97fSAlfred Perlstein.Fn vfs_getvfs 511f620c2eSRuslan Ermilovis NFS, which uses the 521f620c2eSRuslan Ermilov.Vt fsid 531f620c2eSRuslan Ermilovas part of file handles in order to determine the 54ffc0b97fSAlfred Perlsteinfilesystem a given RPC is for. 55ffc0b97fSAlfred PerlsteinIf 56ffc0b97fSAlfred Perlstein.Fn vfs_getvfs 57ffc0b97fSAlfred Perlsteinfails to find the mount point related to 581f620c2eSRuslan Ermilov.Fa fsid , 59ffc0b97fSAlfred Perlsteinthe filesystem is considered stale. 60ffc0b97fSAlfred Perlstein.Sh RETURN VALUES 61ffc0b97fSAlfred PerlsteinIf 62ffc0b97fSAlfred Perlstein.Fa fsid 631f620c2eSRuslan Ermilovis found, the mount point for the ID is returned; otherwise, 64ffc0b97fSAlfred Perlstein.Dv NULL 65ffc0b97fSAlfred Perlsteinis returned. 66ffc0b97fSAlfred Perlstein.Sh PSEUDOCODE 67ffc0b97fSAlfred Perlstein.Bd -literal 68ffc0b97fSAlfred Perlsteinif ((mp = vfs_getvfs(&fhp->fh_fsid)) == NULL) { 69ffc0b97fSAlfred Perlstein error = ESTALE; 70ffc0b97fSAlfred Perlstein goto out; 71ffc0b97fSAlfred Perlstein} 72ffc0b97fSAlfred Perlstein.Ed 731f620c2eSRuslan Ermilov.Sh SEE ALSO 741f620c2eSRuslan Ermilov.Xr vfs_getnewfsid 9 75ffc0b97fSAlfred Perlstein.Sh AUTHORS 76ffc0b97fSAlfred PerlsteinThis man page was written by 77ffc0b97fSAlfred Perlstein.An Chad David Aq davidc@acns.ab.ca . 78