From d2650add2dcaa12e98ef6c5d98fb288225de9032 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Fri, 1 May 2009 22:28:08 +0200 Subject: Fix a couple of invalid DocBook XML usages in the Samba3 Developers Guide. --- docs-xml/Samba3-Developers-Guide/index.xml | 8 +++--- docs-xml/Samba3-Developers-Guide/vfs.xml | 41 +++++++++++++++--------------- 2 files changed, 25 insertions(+), 24 deletions(-) (limited to 'docs-xml/Samba3-Developers-Guide') diff --git a/docs-xml/Samba3-Developers-Guide/index.xml b/docs-xml/Samba3-Developers-Guide/index.xml index 0e5b688874..503fd22c11 100644 --- a/docs-xml/Samba3-Developers-Guide/index.xml +++ b/docs-xml/Samba3-Developers-Guide/index.xml @@ -35,10 +35,10 @@ distribution. A copy can be found on-line at http://www.fsf.org/licenses/gpl.txt - - This document is incomplete and unmaintained. It is merely a - collection of development-related notes. - + + This document is incomplete and unmaintained. It is merely a + collection of development-related notes. + diff --git a/docs-xml/Samba3-Developers-Guide/vfs.xml b/docs-xml/Samba3-Developers-Guide/vfs.xml index 96d512c8f3..f70fc96f37 100644 --- a/docs-xml/Samba3-Developers-Guide/vfs.xml +++ b/docs-xml/Samba3-Developers-Guide/vfs.xml @@ -59,14 +59,14 @@ parameters. A VFS module has three major components: -An initialization function that is + An initialization function that is called during the module load to register implemented -operations. -An operations table representing a +operations. +An operations table representing a mapping between statically defined module functions and VFS layer -operations. -Module functions that do actual -work. +operations. +Module functions that do actual + work. @@ -93,11 +93,11 @@ corruption when accessing (changed) Samba structures. Therefore, initialization function passes three parameters to the VFS registration function, smb_register_vfs() - interface version number, as constant - SMB_VFS_INTERFACE_VERSION, - module name, under which Samba core - will know it, and - an operations' table. + interface version number, as constant + SMB_VFS_INTERFACE_VERSION, + module name, under which Samba core + will know it, and + an operations' table. @@ -106,35 +106,36 @@ functions in the module would correspond to specific VFS operations and how those functions would co-operate with the rest of VFS subsystem. Each operation could perform in a following ways: - transparent, meaning that while + transparent, meaning that while operation is overriden, the module will still call a previous implementation, before or after its own action. This mode is indicated by the constant - SMB_VFS_LAYER_TRANSPARENT; + SMB_VFS_LAYER_TRANSPARENT; - opaque, for the implementations that + opaque, for the implementations that are terminating sequence of actions. For example, it is used to implement POSIX operation on top of non-POSIX file system or even not a file system at all, like a database for a personal audio collection. Use constant SMB_VFS_LAYER_OPAQUE for - this mode; - splitter, a way when some file system + this mode; + splitter, a way when some file system activity is done in addition to the transparently calling previous implentation. This usually involves mangling the result of that call before returning it back to the caller. This mode is selected by - SMB_VFS_LAYER_SPLITTER constant; - logger does not change anything or + SMB_VFS_LAYER_SPLITTER constant; + logger does not change anything or performs any additional VFS operations. When logger module acts, information about operations is logged somewhere using an external facility (or Samba's own debugging tools) but not the VFS layer. In order to describe this type of activity use constant SMB_VFS_LAYER_LOGGER; + - On contrary, scanner module does call + On contrary, scanner module does call other VFS operations while processing the data that goes through the system. This type of operation is indicated by the - SMB_VFS_LAYER_SCANNER constant. + SMB_VFS_LAYER_SCANNER constant. -- cgit