<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>securityfs_create_file</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="The Linux Kernel API" /><link rel="up" href="ch11.html" title="Chapter 11. Security Framework" /><link rel="prev" href="re459.html" title="register_security" /><link rel="next" href="re461.html" title="securityfs_create_dir" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>securityfs_create_file</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re459.html">Prev</a> </td><th width="60%" align="center">Chapter 11. Security Framework</th><td width="20%" align="right"> <a accesskey="n" href="re461.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="securityfs_create_file"><a id="API-securityfs-create-file"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>securityfs_create_file —
create a file in the securityfs filesystem
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">struct dentry * <b class="fsfunc">securityfs_create_file </b>(</code></td><td>const char * <var class="pdparam">name</var>, </td></tr><tr><td> </td><td>mode_t <var class="pdparam">mode</var>, </td></tr><tr><td> </td><td>struct dentry * <var class="pdparam">parent</var>, </td></tr><tr><td> </td><td>void * <var class="pdparam">data</var>, </td></tr><tr><td> </td><td>const struct file_operations * <var class="pdparam">fops</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id2688892"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
a pointer to a string containing the name of the file to create.
</p></dd><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
the permission that the file should have
</p></dd><dt><span class="term"><em class="parameter"><code>parent</code></em></span></dt><dd><p>
a pointer to the parent dentry for this file. This should be a
directory dentry if set. If this parameter is <code class="constant">NULL</code>, then the
file will be created in the root of the securityfs filesystem.
</p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
a pointer to something that the caller will want to get to later
on. The inode.i_private pointer will point to this value on
the <code class="function">open</code> call.
</p></dd><dt><span class="term"><em class="parameter"><code>fops</code></em></span></dt><dd><p>
a pointer to a struct file_operations that should be used for
this file.
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id2689003"></a><h2>Description</h2><p>
This is the basic <span class="quote">“<span class="quote">create a file</span>”</span> function for securityfs. It allows for a
wide range of flexibility in creating a file, or a directory (if you
want to create a directory, the <code class="function">securityfs_create_dir</code> function is
recommended to be used instead).
</p><p>
This function returns a pointer to a dentry if it succeeds. This
pointer must be passed to the <code class="function">securityfs_remove</code> function when the file is
to be removed (no automatic cleanup happens if your module is unloaded,
you are responsible here). If an error occurs, the function will return
the erorr value (via ERR_PTR).
</p><p>
If securityfs is not enabled in the kernel, the value <code class="constant">-ENODEV</code> is
returned.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re459.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch11.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re461.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>register_security</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>securityfs_create_dir</span></td></tr></table></div></body></html>
