Page MenuHomeFreeBSD
Differential D30779

vn_fullpath.9: update args after rev 364633
ClosedPublic
Actions

Authored by asomers on Jun 15 2021, 8:25 PM.
Tags
None
Referenced Files
Unknown Object (File)
Fri, Mar 21, 11:28 AM
Unknown Object (File)
Wed, Mar 19, 8:00 AM
Unknown Object (File)
Wed, Mar 5, 8:40 PM
Unknown Object (File)
Feb 23 2025, 10:37 PM
Unknown Object (File)
Feb 22 2025, 11:20 AM
Unknown Object (File)
Feb 22 2025, 4:05 AM
Unknown Object (File)
Feb 7 2025, 10:49 AM
Unknown Object (File)
Jan 28 2025, 8:03 PM
View All 76 Files
Subscribers
imp

Details

Reviewers
mjg
imp
Group Reviewers
manpages
Commits
rGd6e8b20898e1: vn_fullpath.9: update args after rev 364633
rGfcb5a0a2add1: vn_fullpath.9: update args after rev 364633
Summary

vn_fullpath.9: update args after rev 364633

MFC after: 2 weeks
Sponsored by: Axcient

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Revision Contents
Changeset List

PathSize
share/
man/
man9/
8 lines

Diff 90932

View Options

share/man/man9/vn_fullpath.9

Show All 21 Lines
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
.\" DAMAGE. .\" DAMAGE.
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd November 23, 2008 .Dd June 15, 2021
.Dt VN_FULLPATH 9 .Dt VN_FULLPATH 9
.Os .Os
.Sh NAME .Sh NAME
.Nm vn_fullpath .Nm vn_fullpath
.Nd "convert a vnode reference to a full pathname, given a process context" .Nd "convert a vnode reference to a full pathname, given a process context"
.Sh SYNOPSIS .Sh SYNOPSIS
.In sys/param.h .In sys/param.h
.In sys/vnode.h .In sys/vnode.h
.Ft int .Ft int
.Fo vn_fullpath .Fo vn_fullpath
.Fa "struct thread *td" "struct vnode *vp" "char **retbuf" "char **freebuf" .Fa "struct vnode *vp" "char **retbuf" "char **freebuf"
.Fc .Fc
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Fn vn_fullpath .Fn vn_fullpath
function makes a function makes a
.Dq "best effort" .Dq "best effort"
attempt to generate a string pathname for attempt to generate a string pathname for
the passed vnode; the resulting path, if any, will be relative to the passed vnode; the resulting path, if any, will be relative to
Show All 13 Lines
open or referenced). open or referenced).
However, the resulting string may still be more useable to a user than However, the resulting string may still be more useable to a user than
a vnode pointer value, or a device number and inode number. a vnode pointer value, or a device number and inode number.
Code consuming the results of this function should anticipate (and Code consuming the results of this function should anticipate (and
properly handle) failure. properly handle) failure.
.Pp .Pp
Its arguments are: Its arguments are:
.Bl -tag -width ".Fa freebuf" .Bl -tag -width ".Fa freebuf"
.It Fa td
The thread performing the call; this pointer will be dereferenced to find
the process and its file descriptor structure, in order to identify the
root vnode to use.
.It Fa vp .It Fa vp
The vnode to search for. The vnode to search for.
No need to be locked by the caller. No need to be locked by the caller.
.It Fa retbuf .It Fa retbuf
Pointer to a Pointer to a
.Vt "char *" .Vt "char *"
that that
.Fn vn_fullpath .Fn vn_fullpath
▲ Show 20 Lines • Show All 44 Lines • Show Last 20 Lines