1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fileid</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_fileid.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fileid — Generates file_id structs with unique device id values for 2 cluster setups</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fileid</code></p></div></div><div class="refsect1" lang="en"><a name="id2522904"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the 3 <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> 4 suite.</p><p>Samba uses file_id structs to uniquely identify files 5 for locking purpose. By default the file_id contains the device 6 and inode number returned by the <code class="literal">stat()</code> system call. 7 As the file_id is a unique identifier of a file, it must be the same 8 on all nodes in a cluster setup. This module overloads the 9 <code class="literal">SMB_VFS_FILE_ID_CREATE()</code> operation and 10 generates the device number based on the configured algorithm 11 (see the "fileid:algorithm" option). 12 </p></div><div class="refsect1" lang="en"><a name="id2483313"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">fileid:algorithm = ALGORITHM</span></dt><dd><p>Available algorithms are <code class="literal">fsname</code> 13 and <code class="literal">fsid</code>. The default value is 14 <code class="literal">fsname</code>. 15 </p><p>The <code class="literal">fsname</code> algorithm generates 16 device id by hashing the kernel device name. 17 </p><p>The <code class="literal">fsid</code> algorithm generates 18 the device id from the <code class="literal">f_fsid</code> returned 19 from the <code class="literal">statfs()</code> syscall. 20 </p></dd><dt><span class="term">fileid:mapping = ALGORITHM</span></dt><dd><p>This option is the legacy version of the 21 <code class="literal">fileid:algorithm</code> option, which was used in earlier 22 versions of fileid mapping feature in custom Samba 3.0 versions. 23 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483535"></a><h2>EXAMPLES</h2><p>Usage of the <code class="literal">fileid</code> module with the 24 <code class="literal">fsid</code> algorithm:</p><pre class="programlisting"> 25 <em class="parameter"><code>[global]</code></em> 26 <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = fileid</a> 27 <a class="link" href="smb.conf.5.html#FILEID:ALGORITHM" target="_top">fileid:algorithm = fsid</a> 28</pre></div><div class="refsect1" lang="en"><a name="id2483692"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite. 29 </p></div><div class="refsect1" lang="en"><a name="id2483703"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities 30 were created by Andrew Tridgell. Samba is now developed 31 by the Samba Team as an Open Source project similar 32 to the way the Linux kernel is developed.</p></div></div></body></html> 33