.TH "devfs_get_handle" 9 "devfs_get_handle" "25 May 1998" "Kernel Hacker's Manual" LINUX
.SH NAME
devfs_get_handle \-  Find the handle of a devfs entry.
.SH SYNOPSIS
.B "devfs_handle_t" devfs_get_handle
.BI "(devfs_handle_t " dir ","
.BI "const char *" name ","
.BI "unsigned int " major ","
.BI "unsigned int " minor ","
.BI "char " type ","
.BI "int " traverse_symlinks ");"
.SH ARGUMENTS
.IP "dir" 12
 The handle to the parent devfs directory entry. If this is NULL the
name is relative to the root of the devfs.
.IP "name" 12
 The name of the entry.
.IP "major" 12
 The major number. This is used if \fIname\fP is NULL.
.IP "minor" 12
 The minor number. This is used if \fIname\fP is NULL.
.IP "type" 12
 The type of special file to search for. This may be either
DEVFS_SPECIAL_CHR or DEVFS_SPECIAL_BLK.
.IP "traverse_symlinks" 12
 If TRUE then symlink entries in the devfs namespace are
traversed. Symlinks pointing out of the devfs namespace will cause a
failure. Symlink traversal consumes stack space.
.SH "DESCRIPTION"
Returns a handle which may later be used in a call to
\fBdevfs_unregister\fP, \fBdevfs_get_flags\fP, or \fBdevfs_set_flags\fP. A
subsequent \fBdevfs_put\fP is required to decrement the refcount.
On failure NULL is returned.