mirror of
https://github.com/samba-team/samba.git
synced 2024-12-22 13:34:15 +03:00
857745655b
glusterfs:volfile_server option can be used in smb.conf to define where to fetch the volfile from. Currently it supports only a single IP or a hostname. The default is 'localhost'. glfs_set_volfile_server() has been enhanced in gfapi to support multiple invocations. A list is maintained in libgfapi which gets appended on every invocation. When glfs_init is performed, libgfapi would first try to fetch the volfile from glusterd on that node. However, on failure to fetch the volfile, it would proceed to contact glusterd on every node in the list until it gets the volfile or exhausts the list. This enhacement was done in Gluster commit [2]. This commit is available in 3.6, 3.7, 3.8 versions of Gluster. As we cannot have multiple lines having the same key of glusterfs:volfile_server in a share definition in smb.conf, we propose a scheme like this: where value of glusterfs:volfile_server could be list of white space seperated elements where each element could be unix+/path/to/socket/file or [tcp+]IP|hostname|\[IPv6\][:port]. Note the restriction on naming a IPv6 host, it follows the same restriction that is based on IPv6 naming in URL as per RFC 2732[1]. [1] http://www.ietf.org/rfc/rfc2732.txt [2] 0c1d78f5c52c69268ec3a1d8d5fcb1a1bf15f243 Signed-off-by: Raghavendra Talur <rtalur@redhat.com> Reviewed-by: Jeremy Allison <jra@samba.org> Reviewed-by: Michael Adam <obnox@samba.org> Reviewed-by: Guenther Deschner <gd@samba.org> Autobuild-User(master): Günther Deschner <gd@samba.org> Autobuild-Date(master): Fri Oct 14 17:09:24 CEST 2016 on sn-devel-144 |
||
|---|---|---|
| .. | ||
| archives | ||
| build | ||
| manpages | ||
| registry | ||
| Samba3-ByExample | ||
| Samba3-Developers-Guide | ||
| Samba3-HOWTO | ||
| scripts | ||
| smbdotconf | ||
| templates | ||
| test | ||
| using_samba | ||
| xslt | ||
| .gitignore | ||
| aclocal.m4 | ||
| configure.ac | ||
| gpl-3.0.xml | ||
| htmldocs.html | ||
| Makefile | ||
| Makefile.settings.in | ||
| README | ||
| Samba-EventLog-HOWTO.txt | ||
| Samba.desktop | ||
| structure.svg | ||
| wscript_build | ||
!== !== docbook.txt for Samba 3.0 !== !== Author: David Bannon, D.Bannon@latrobe.edu.au November, 2000 !== Updates: Gerald (Jerry) Carter, jerry@samba.org, Feb. 2001 !== Updates: Jelmer Vernooij, jelmer@samba.org, Aug, 2002 !== Updates: Jelmer Vernooij, jelmer@samba.org, Jun, 2003 !== Updates: Jelmer Vernooij, jelmer@samba.org, May, 2004 !== Updates: Jelmer Vernooij, jelmer@samba.org, May, 2005 Quick start ----------- Run: $ make all or to see what is possible: $ make help What are DocBook documents doing in the Samba Distribution ? ----------------------------------------------------------- We have converted all samba docs to XML/DocBook V4.2 in order to make them easier to maintain and produce a nicer looking product. This short note (strange isn't it how it always starts out as a short note and becomes a long one ?) will explain very briefly how and why we have done this. The format ---------- If you are new to xml, regard an xml file as 'source code'. You don't read it directly, but use it to create other formats (like the txt and html included in ../txtdocs and ../htmldocs). Docbook is a particular XML style, particularly suited to producing technical manuals. For more information on DocBook tags and format, see "DocBook: The Definitive Guide" by Walsh and Muellner, (c) O'Reilly Publishing. This book covers DocBook V4.2 and is available on-line at http://www.docbook.org/ The Output ---------- The current Samba Subversion tree contains the XML/DocBook source files. A regularly generated version can be found at http://samba.org/samba/docs/. The Tools --------- To generate the docs, you need to have the following packages installed: * GNU Make * GNU autoconf * xsltproc * inkscape For generating PDF and PostScript (thru LaTeX): * dblatex (from http://dblatex.sf.net/) For generating PDF (thru FO): * fop (http://xml.apache.org/fop/) For generating ASCII: * html2text For generating Palm-viewable docs: * plucker-build For generating texi files: * docbook2x-texi * makeinfo For validating: * xmllint This directory now contains a ./configure script and Makefile to support the automated building of man pages (including HTML versions), and the building of the Samba-HOWTO-Collection and the Samba Developers Guide (HTML,TeX,PDF,PS,Text versions). The configure script detects which of the required utilities are installed and builds as much docs as it can using these tools. Help! Building the docs generates a lot of HTTP traffic... ---------------------------------------------------------- To be able to build the docs without an internet connection (or faster with a slow internet connection), you need to set up "catalogs". For the Pearson DTD, add something like: <public publicId="-//Pearson//DTD Books//DE" uri="file:///home/jelmer/Xml_dtd_1.1/pearson.dtd"/> For the Samba DTD's, add something like: <rewriteURI uriStartString="http://www.samba.org/samba/DTD" rewritePrefix="file:///home/jelmer/samba-web/DTD"/> catalog entries for the other DTD's and XSL scripts should be present on your system already. Windows Help files ---------- http://htmlhelp.berlios.de/howto/mshh4wine.php