'\" t .\" Title: debugfs_create_symlink .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: The debugfs filesystem .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "DEBUGFS_CREATE_SYMLI" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "The debugfs filesystem" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" debugfs_create_symlink \- create a symbolic link in the debugfs filesystem .SH "SYNOPSIS" .HP \w'struct\ dentry\ *\ debugfs_create_symlink('u .BI "struct dentry * debugfs_create_symlink(const\ char\ *\ " "name" ", struct\ dentry\ *\ " "parent" ", const\ char\ *\ " "target" ");" .SH "ARGUMENTS" .PP \fIname\fR .RS 4 a pointer to a string containing the name of the symbolic link to create\&. .RE .PP \fIparent\fR .RS 4 a pointer to the parent dentry for this symbolic link\&. This should be a directory dentry if set\&. If this parameter is NULL, then the symbolic link will be created in the root of the debugfs filesystem\&. .RE .PP \fItarget\fR .RS 4 a pointer to a string containing the path to the target of the symbolic link\&. .RE .SH "DESCRIPTION" .PP This function creates a symbolic link with the given name in debugfs that links to the given target path\&. .PP This function will return a pointer to a dentry if it succeeds\&. This pointer must be passed to the \fBdebugfs_remove\fR function when the symbolic link is to be removed (no automatic cleanup happens if your module is unloaded, you are responsible here\&.) If an error occurs, \fBNULL\fR will be returned\&. .PP If debugfs is not enabled in the kernel, the value \-\fBENODEV\fR will be returned\&. .SH "COPYRIGHT" .br