isatty.3: Most non-tty files nowadays result in the error ENOTTY

[thirdparty/man-pages.git] / man2 / lookup_dcookie.2

diff --git a/man2/lookup_dcookie.2 b/man2/lookup_dcookie.2
index 8e091dfa84a7a5b0166ac94bb9e9a26f7795ec95..24ae1d538fc843b3148817aae169ad665d5e4c60 100644 (file)
--- a/man2/lookup_dcookie.2
+++ b/man2/lookup_dcookie.2
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (C) 2003 John Levon <levon@movementarian.org>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,27 +20,27 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Modified 2004-06-17 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
-.TH LOOKUP_DCOOKIE 2 2004-06-17 "Linux" "Linux Programmer's Manual"
+.TH LOOKUP_DCOOKIE 2 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 lookup_dcookie \- return a directory entry's path
 .SH SYNOPSIS
 .BI "int lookup_dcookie(u64 " cookie ", char *" buffer ", size_t " len );
 .SH DESCRIPTION
 Look up the full path of the directory entry specified by the value
-.I cookie
-.
+.IR cookie .
 The cookie is an opaque identifier uniquely identifying a particular
 directory entry.
 The buffer given is filled in with the full path of the directory entry.
-
+.PP
 For
 .BR lookup_dcookie ()
 to return successfully,
 the kernel must still hold a cookie reference to the directory entry.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success,
 .BR lookup_dcookie ()
 returns the length of the path string copied into the buffer.
@@ -76,13 +75,17 @@ Available since Linux 2.5.43.
 The
 .B ENAMETOOLONG
 error return was added in 2.5.70.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 .BR lookup_dcookie ()
 is Linux-specific.
-.SH "NOTES"
+.SH NOTES
 .BR lookup_dcookie ()
-is a special-purpose system call, currently used only by the oprofile profiler.
+is a special-purpose system call, currently used only by the
+.BR oprofile (1)
+profiler.
 It relies on a kernel driver to register cookies for directory entries.
-
+.PP
 The path returned may be suffixed by the string " (deleted)" if the directory
 entry has been removed.
+.SH SEE ALSO
+.BR oprofile (1)