# James Moore <jmoore@php.net>
# Gerald Carter <jerry@samba.org>
# Jelmer Vernooij <jelmer@samba.org>
-#
-# Please see http://www.samba.org/samba/cvs.html
-# for information on getting the latest
-# source and documentation source files.
-#
-#
# Programs
WGET = @WGET@
MANDIR = $(OUTPUTDIR)/manpages
EPSTOPDF = @EPSTOPDF@
MANPAGEDIR = manpages
-HOWTODIR = howto
-GUIDEDOC = guide
-DEVDOCDIR = devel
MAKEINDEX = @MAKEINDEX@
-IMAGEPROJDIR = $(HOWTODIR)/imagefiles
-IMAGEGUIDEDIR = $(GUIDEDOC)/images
EXAMPLESDIR = examples
SMBDOTCONFDOC = smbdotconf
+DOCBOOKDIR = tmp
PSDIR = $(OUTPUTDIR)
PDFDIR = $(OUTPUTDIR)
DVIDIR = $(OUTPUTDIR)
HTMLDIR=$(OUTPUTDIR)/htmldocs
PLUCKERDIR=$(OUTPUTDIR)/plucker
+# Docs to build
+MAIN_DOCS = $(patsubst %/index.xml,$(DOCBOOKDIR)/%.xml,$(wildcard */index.xml))
+MANPAGES = $(wildcard $(MANPAGEDIR)/*.?.xml)
+
# Lists of files to process
LATEX_FIGURES = xslt/figures/caution.pdf xslt/figures/important.pdf xslt/figures/note.pdf xslt/figures/tip.pdf xslt/figures/warning.pdf
-MANPAGES_SOURCES = $(wildcard $(MANPAGEDIR)/*.?.xml)
-MANPAGES = $(patsubst $(MANPAGEDIR)/%.xml,$(MANDIR)/%,$(MANPAGES_SOURCES)) $(MANDIR)/smb.conf.5
-MANPAGES_HTML = $(patsubst $(MANPAGEDIR)/%.xml,$(HTMLDIR)/%.html,$(MANPAGES_SOURCES)) $(HTMLDIR)/smb.conf.5.html $(HTMLDIR)/manpages.html
-MANPAGES_PLUCKER = $(patsubst $(MANPAGEDIR)/%.xml,$(PLUCKERDIR)/%.pdb,$(MANPAGES_SOURCES)) $(PLUCKERDIR)/smb.conf.5.pdb
+MANPAGES_PLUCKER = $(patsubst $(MANPAGEDIR)/%.xml,$(PLUCKERDIR)/%.pdb,$(MANPAGES_SOURCES))
+
+Samba_HOWTO_Collection_IMAGES_PNG = $(wildcard Samba-HOWTO-Collection/imagefiles/*.png)
+Samba_Guide_IMAGES_PNG = $(wildcard Samba-Guide/images/*.png)
-HOWTODIR_IMAGES_PNG = $(wildcard $(IMAGEPROJDIR)/*.png)
-GUIDEDOC_IMAGES_PNG = $(wildcard $(IMAGEGUIDEDIR)/*.png)
-HOWTODIR_IMAGES_EPS=$(patsubst %.png,%.eps,$(wildcard $(IMAGEPROJDIR)/*.png))
-HOWTODIR_DEPS = $(HOWTODIR)/*.xml $(HOWTODIR)/attributions.xml $(MANPAGEDIR)/*.xml smb.conf.5.xml $(SMBDOTCONFDOC)/parameters.all.xml $(SMBDOTCONFDOC)/parameters.global.xml $(SMBDOTCONFDOC)/parameters.service.xml
-DEVDOCDIR_DEPS = $(DEVDOCDIR)/*.xml $(DEVDOCDIR)/attributions.xml
+Samba_HOWTO_Collection_IMAGEDIR = Samba-HOWTO-Collection/imagefiles
+Samba_Guide_IMAGEDIR = Samba-Guide/images
+
+Samba_HOWTO_Collection_IMAGES_EPS = $(patsubst %.png,%.eps,$(Samba_HOWTO_Collection_IMAGES_PNG))
+Samba_Guide_IMAGES_EPS = $(patsubst %.png,%.eps,$(Samba_Guide_IMAGES_PNG))
help:
@echo "Supported make targets:"
- @echo "release - Build the docs needed for a Samba release"
- @echo "pdf - Build PDF version of book"
- @echo "tex - Build Latex version of book"
- @echo "dvi - Build Device Independant File of book"
- @echo "ps - Build PostScript version of book"
- @echo "manpages - Build manpages"
- @echo "txt - Build plain text version of HOWTO Collection and Developers Guide"
- @echo -n "html-single - Build single file HTML version of HOWTO Collection"
- @echo " and developers guide"
- @echo "html - Build HTML version of HOWTO Collection and Developers Guide"
- @echo "htmlman - Build html version of manpages"
- @echo "plucker - Build HOWTO, Developers Guide, man pages in Plucker format for PDA"
- @echo "undocumented - Output list of undocumented smb.conf options"
- @echo "samples - Extract examples"
- @echo "files - Extract other files"
- @echo "all - Build all docs that can be build using the utilities found by configure"
- @echo "everything - Build all of the above"
-
+ @echo " release - Build the docs needed for a Samba release"
+ @echo " all - Build all docs that can be build using the utilities found by configure"
+ @echo " everything - Build all of the above"
+ @echo " pdf,tex,dvi,ps,manpages,txt,pearson,fo,htmlhelp - Build specific output format"
+ @echo " html - Build multi-file HTML version of HOWTO Collection, Guide and Dev-Guide"
+ @echo " html-single - Build single-file HTML version of HOWTO Collection, Guide and Dev-Guide"
+ @echo " htmlman - Build HTML version of manpages"
+ @echo " undocumented - Output list of undocumented smb.conf options"
+ @echo " samples - Extract examples"
+ @echo " files - Extract other files"
+
+Samba-Guide/index.xml: $(subst Samba-Guide/index.xml,,$(wildcard Samba-Guide/*.xml))
+Samba-HOWTO-Collection/index.xml: $(subst Samba-HOWTO-Collection/index.xml,,$(wildcard Samba-HOWTO-Collection/*.xml)) Samba-HOWTO-Collection-attributions.xml
+Samba-Developers-Guide/index.xml: $(subst Samba-Developers-Guide/index.xml,,$(wildcard Samba-Developers-Guide/*.xml)) Samba-Developers-Guide-attributions.xml
+
+# Pseudo targets
all: @TARGETS@
-
-everything: manpages pdf html-single html htmlman txt ps
-
+everything: manpages pdf html-single html htmlman txt ps fo htmlhelp pearson verify
release: manpages htmlman html pdf guide
-# Global rules
-
-pdf: $(PDFDIR) $(PDFDIR)/Samba-HOWTO-Collection.pdf $(PDFDIR)/Samba-Developers-Guide.pdf
-
-dvi: $(DVIDIR) $(DVIDIR)/Samba-HOWTO-Collection.dvi $(DVIDIR)/Samba-Developers-Guide.dvi
-
-ps: $(PSDIR) $(PSDIR)/Samba-HOWTO-Collection.ps $(PSDIR)/Samba-Developers-Guide.ps
+# Output format targets
+pdf: $(patsubst $(DOCBOOKDIR)/%.xml,$(PDFDIR)/%.pdf,$(MAIN_DOCS))
+dvi: $(patsubst $(DOCBOOKDIR)/%.xml,$(DVIDIR)/%.dvi,$(MAIN_DOCS))
+ps: $(patsubst $(DOCBOOKDIR)/%.xml,$(PSDIR)/%.ps,$(MAIN_DOCS))
+txt: $(patsubst $(DOCBOOKDIR)/%.xml,$(TXTDIR)/%.txt,$(MAIN_DOCS))
+fo: $(patsubst $(DOCBOOKDIR)/%.xml,$(FODIR)/%.fo,$(MAIN_DOCS))
+tex: $(patsubst $(DOCBOOKDIR)/%.xml,%.tex,$(MAIN_DOCS))
+manpages: $(patsubst $(MANPAGEDIR)/%.xml,$(MANDIR)/%,$(MANPAGES))
+pearson: $(PEARSONDIR)/Samba-HOWTO-Collection.xml
+pearson-verify: $(PEARSONDIR)/Samba-HOWTO-Collection.report.html
+plucker: $(patsubst $(DOCBOOKDIR)/%.xml,$(PLUCKERDIR)/%.pdb,$(MAIN_DOCS))
+htmlman: $(patsubst $(MANPAGEDIR)/%.xml,$(HTMLDIR)/%.html,$(MANPAGES)) $(HTMLDIR)/manpages.html
+html-single: $(patsubst $(DOCBOOKDIR)/%.xml,$(HTMLDIR)/%.html,$(MAIN_DOCS))
+html: $(patsubst $(DOCBOOKDIR)/%.xml,$(HTMLDIR)/%/index.html,$(MAIN_DOCS)) $(HTMLDIR)/index.html
+htmlhelp: $(patsubst $(DOCBOOKDIR)/%.xml,$(HTMLHELPDIR)/%,$(MAIN_DOCS))
-txt: $(TXTDIR) $(TXTDIR)/Samba-HOWTO-Collection.txt $(TXTDIR)/Samba-Developers-Guide.txt
+# Intermediate docbook docs
-fo: $(FODIR) $(FODIR)/Samba-HOWTO-Collection.fo $(FODIR)/Samba-Developers-Guide.fo
+$(DOCBOOKDIR):
+ mkdir $@
-htmlman: $(HTMLDIR) $(MANPAGES_HTML) $(HTMLDIR)/samba.css
+$(DOCBOOKDIR)/%.xml: %/index.xml $(DOCBOOKDIR) xslt/expand-sambadoc.xsl
+ $(XSLTPROC) --stringparam noreference 1 --stringparam imagedir "$($(subst -,_,$*)_IMAGEDIR)/" --xinclude --output $@ xslt/expand-sambadoc.xsl $<
-html-single: $(HTMLDIR) $(HTMLDIR)/samba.css $(HTMLDIR)/Samba-HOWTO-Collection.html $(HTMLDIR)/Samba-Developers-Guide.html $(HTMLDIR)/Samba-Guide.html
- cp -p $(GUIDEDOC_IMAGES_PNG) $(HOWTODIR_IMAGES_PNG) $(HTMLDIR)/images/
+$(DOCBOOKDIR)/%.xml: $(MANPAGEDIR)/%.xml $(DOCBOOKDIR) xslt/expand-sambadoc.xsl
+ $(XSLTPROC) --stringparam noreference 1 --output $@ xslt/expand-sambadoc.xsl $<
-html: $(HTMLDIR)/howto $(HTMLDIR)/guide $(HTMLDIR)/devel $(HTMLDIR)/index.html
+manpages.xml: $(MANPAGES_SOURCES) xslt/manpage-summary.xsl
+ echo "<article><variablelist>" > $@
+ for I in $(MANPAGES_SOURCES); do $(XSLTPROC) xslt/manpage-summary.xsl $$I >> $@; done
+ echo "</variablelist></article>" >> $@
-htmlhelp: $(HTMLHELPDIR)/Samba-HOWTO-Collection $(HTMLHELPDIR)/Samba-Developers-Guide $(HTMLHELPDIR)/Samba-Guide
+# HTML docs
$(HTMLDIR)/index.html: htmldocs.html $(HTMLDIR)
cp $< $@
-$(HTMLDIR)/howto: $(HTMLDIR) $(HTMLDIR)/howto/samba.css Samba-HOWTO-Collection.xml
- $(XSLTPROC) --stringparam base.dir "$(HTMLDIR)/howto/" xslt/html-chunk.xsl Samba-HOWTO-Collection.xml
- -mkdir $(HTMLDIR)/howto/images
- cp -R $(HOWTODIR_IMAGES_PNG) $(HTMLDIR)/howto/images
-
-$(HTMLDIR)/devel: $(HTMLDIR) $(HTMLDIR)/devel/samba.css Samba-Developers-Guide.xml
- $(XSLTPROC) --stringparam base.dir "$(HTMLDIR)/devel/" xslt/html-chunk.xsl Samba-Developers-Guide.xml
-
-$(HTMLDIR)/guide: $(HTMLDIR) $(HTMLDIR)/guide/samba.css Samba-Guide.xml
- $(XSLTPROC) --stringparam base.dir "$(HTMLDIR)/guide/" xslt/html-chunk.xsl Samba-Guide.xml
- -mkdir $(HTMLDIR)/guide/images
- cp -R $(GUIDEDOC_IMAGES_PNG) $(HTMLDIR)/guide/images
-
-manpages: $(MANDIR) $(MANPAGES)
-
-manpages.xml: $(MANPAGES_SOURCES)
- echo "<article><variablelist>" > $@
- for I in $(MANPAGES_SOURCES); do $(XSLTPROC) xslt/manpage-summary.xsl $$I >> $@; done
- echo "</variablelist></article>" >> $@
-
-tex: Samba-HOWTO-Collection.tex Samba-Developers-Guide.tex gpl.tex
+$(HTMLDIR)/%/index.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/% $(HTMLDIR)/%/samba.css xslt/html-chunk.xsl
+ $(XSLTPROC) --stringparam base.dir "$(HTMLDIR)/$*/" xslt/html-chunk.xsl $<
+ -mkdir $(HTMLDIR)/$*/images
-plucker: html-single htmlman $(PLUCKERDIR) $(MANPAGES_PLUCKER) $(PLUCKERDIR)/Samba-Developers-Guide.pdb $(PLUCKERDIR)/Samba-HOWTO-Collection.pdb
+# Single large HTML files
+$(HTMLDIR):
+ mkdir $(HTMLDIR)
+ mkdir $(HTMLDIR)/images
-Samba-HOWTO-Collection.xml: $(HOWTODIR)/index.xml $(HOWTODIR_DEPS)
- $(XSLTPROC) --stringparam noreference 1 --xinclude --output $@ xslt/expand-sambadoc.xsl $<
+$(OUTPUTDIR)/%/samba.css: xslt/html/samba.css
+ cp $< $@
-Samba-Guide.xml: $(GUIDEDOC)/guide-main.xml
- $(XSLTPROC) --stringparam noreference 1 --xinclude --output $@ xslt/expand-sambadoc.xsl $<
+$(HTMLDIR)/%.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR) $(HTMLDIR)/samba.css $(patsubst %.png,$(HTMLDIR)/images/%.png,$(%_IMAGES_PNG)) xslt/html.xsl
+ echo $^
+ $(XSLTPROC) --output $@ xslt/html.xsl $<
-Samba-Developers-Guide.xml: $(DEVDOCDIR)/index.xml $(DEVDOCDIR_DEPS)
- $(XSLTPROC) --stringparam noreference 1 --xinclude --output $@ xslt/expand-sambadoc.xsl $<
+$(patsubst $(DOCBOOKDIR)/%.xml,$(HTMLDIR)/%,$(MAIN_DOCS)): $(HTMLDIR)
+ -mkdir $@
-%/attributions.xml: %/index.xml
- @echo "<empty/>" > $@ # Make sure we don't get recursive dependencies, etc!
- $(XSLTPROC) --output $@ xslt/generate-attributions.xsl $<
+%-attributions.xml:
+ echo "<para/>" > $@
+ $(XSLTPROC) --xinclude xslt/generate-attributions.xsl $*/index.xml > $@
clean:
- rm -rf $(OUTPUTDIR)/*
- rm -f *.xml $(MANPAGES) $(TXTDIR)/*.txt $(PSDIR)/*.ps \
- $(PDFDIR)/*.pdf $(HTMLDIR)/*html $(HTMLDIR)/samba.css
+ rm -rf $(OUTPUTDIR)/* $(DOCBOOKDIR)
+ rm -f *.xml
rm -f xslt/figures/*pdf
- rm -f $(SMBDOTCONFDOC)/parameters.*.xml $(DVIDIR)/*.dvi
- rm -f samba-doc.* index.* $(HOWTODIR)/changelog.xml $(HOWTODIR)/attributions.xml $(DEVDOCDIR)/attributions.xml
- rm -f Samba-HOWTO-Collection.*
- rm -f Samba-Developers-Guide.*
- rm -f Samba-Guide.*
- rm -f $(IMAGEPROJDIR)/*.eps
+ rm -f $(SMBDOTCONFDOC)/parameters.*.xml
+ rm -f $(patsubst $(DOCBOOKDIR)/%.xml,%.*,$(MAIN_DOCS))
# Text files
$(TXTDIR):
mkdir $(TXTDIR)
-$(TXTDIR)/%.txt: $(HTMLDIR)/%.html
+$(TXTDIR)/%.txt: $(HTMLDIR)/%.html $(TXTDIR)
$(HTML2TEXT) -nobs -style pretty -o $@ $<
# Tex files
-%.tex: %.xml
+%.tex: $(DOCBOOKDIR)/%.xml xslt/latex.xsl
$(XSLTPROC) --output $@ xslt/latex.xsl $<
gpl.tex:
-$(PDFLATEX) $<
%.idx: %.aux
- $(MAKEINDEX) `echo $< | sed -e 's/.aux//'`
+ $(MAKEINDEX) $*
# Adobe PDF files
-$(PDFDIR)/%.pdf: %.tex %.aux %.idx latexfigures gpl.tex
+$(PDFDIR)/%.pdf: %.tex %.aux %.idx latexfigures gpl.tex $(PDFDIR) $(%_IMAGES_PNG)
-$(PDFLATEX) $<
-$(PDFLATEX) $<
- $(THUMBPDF) $(patsubst %.tex,%.pdf,$<)
+ $(THUMBPDF) $*.pdf
-$(PDFLATEX) $<
- mv $(patsubst %.tex,%.pdf,$<) $@
-
-epsimages: $(HOWTODIR_IMAGES_EPS)
+ mv $*.pdf $@
# DVI files
-$(DVIDIR)/%.dvi: %.tex %.aux %.idx epsimages gpl.tex
+$(DVIDIR)/%.dvi: %.tex %.aux %.idx gpl.tex $(DVIDIR) $(%_IMAGES_EPS)
-$(LATEX) $<
-$(LATEX) $<
- mv $(patsubst %.tex,%.dvi,$<) $@
+ mv $*.dvi $@
%.eps: %.png
$(PNGTOPNM) $< | $(PNMTOPS) > $@
# PostScript files
-$(PSDIR)/%.ps: $(DVIDIR)/%.dvi
+$(PSDIR)/%.ps: $(DVIDIR)/%.dvi $(PSDIR)
$(DVIPS) -o $@ $<
xslt/figures/%.pdf: xslt/figures/%.eps
$(FODIR):
mkdir $(FODIR)
-$(FODIR)/%.fo: %.xml $(FODIR)
+$(FODIR)/%.fo: $(DOCBOOKDIR)/%.xml $(FODIR)
$(XSLTPROC) --output $@ http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl $<
# HTML Help
-
$(HTMLHELPDIR):
mkdir $(HTMLHELPDIR)
-$(HTMLHELPDIR)/Samba-HOWTO-Collection/images:
- -mkdir -p $@
- cp -p $(HOWTODIR_IMAGES_PNG) $@
+$(HTMLHELPDIR)/%/images/%.png: $(%_IMAGEDIR)/%.png
+ cp $< $@
-$(HTMLHELPDIR)/Samba-Guide/images:
- -mkdir -p $@
- cp -p $(GUIDEDOC_IMAGES_PNG) $@
+$(HTMLHELPDIR)/%/images: $(HTMLHELPDIR)/%
+ mkdir -p $@
-$(HTMLHELPDIR)/Samba-Developers-Guide/images:
+$(HTMLHELPDIR)/%/images/: $@ $(subst $($*_IMAGEDIR),$@/,$($*_IMAGES_PNG))
-$(HTMLHELPDIR)/%: %.xml $(HTMLHELPDIR) $(HTMLHELPDIR)/%/images
+$(HTMLHELPDIR)/%: $(DOCBOOKDIR)/%.xml $(HTMLHELPDIR) $(HTMLHELPDIR)/%/images/
-mkdir $@
- $(XSLTPROC) --stringparam htmlhelp.chm $(patsubst %.xml,%.chm,$<) --stringparam manifest.in.base.dir "$@/" --stringparam base.dir "$@/" http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl $<
-
-# Single large HTML files
-
-$(HTMLDIR):
- mkdir $(HTMLDIR)
- mkdir $(HTMLDIR)/howto
- mkdir $(HTMLDIR)/guide
- mkdir $(HTMLDIR)/devel
- mkdir $(HTMLDIR)/images
+ $(XSLTPROC) --stringparam htmlhelp.chm $*.chm --stringparam manifest.in.base.dir "$@/" --stringparam base.dir "$@/" http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl $<
+# Plucker docs
$(PLUCKERDIR):
mkdir $(PLUCKERDIR)
-%/samba.css: xslt/html/samba.css
- if [ ! -d `dirname $@` ]; then mkdir -p `dirname $@`; fi
- cp $< $@
-
-$(HTMLDIR)/Samba-HOWTO-Collection.html: Samba-HOWTO-Collection.xml $(HOWTODIR_DEPS) $(HOWTODIR_IMAGES_PNG)
- $(XSLTPROC) --output $@ xslt/html.xsl $<
-
-$(HTMLDIR)/Samba-Guide.html: Samba-Guide.xml $(GUIDEDOC_IMAGES_PNG)
- $(XSLTPROC) --output $@ xslt/html.xsl $<
-
-$(HTMLDIR)/Samba-Developers-Guide.html: Samba-Developers-Guide.xml $(DEVDOCDIR_DEPS)
- $(XSLTPROC) --output $@ xslt/html.xsl $<
-
-$(HTMLDIR)/%.html: %.xml
- $(XSLTPROC) --output $@ xslt/html.xsl $<
-
-$(PLUCKERDIR)/%.pdb: $(HTMLDIR)/%.html
- $(PLUCKERBUILD) -v -M1 --stayonhost --noimages --zlib-compression -H file:$< -f $(patsubst $(PLUCKERDIR)/%.pdb,%,$@) -p $(PLUCKERDIR)
-
-%.xml: $(MANPAGEDIR)/%.xml
- $(XSLTPROC) --stringparam noreference 1 --output $@ xslt/expand-sambadoc.xsl $<
+$(PLUCKERDIR)/%.pdb: $(HTMLDIR)/%.html $(PLUCKERDIR)
+ $(PLUCKERBUILD) -v -M1 --stayonhost --noimages --zlib-compression -H file:$< -f $* -p $(PLUCKERDIR)
# Manpages
$(MANPAGEDIR)/smb.conf.5.xml: $(SMBDOTCONFDOC)/parameters.all.xml $(SMBDOTCONFDOC)/parameters.service.xml $(SMBDOTCONFDOC)/parameters.global.xml
-$(SMBDOTCONF)/parameters.all.xml:
- @cd $(SMBDOTCONFDOC) && /bin/sh generate-file-list.sh >parameters.all.xml
+$(SMBDOTCONFDOC)/parameters.all.xml: $(shell find $(SMBDOTCONFDOC) -type f -name '*.xml' -mindepth 2 | sort -t/ -k3 | xargs) $(SMBDOTCONFDOC)/generate-file-list.sh
+ $(SMBDOTCONFDOC)/generate-file-list.sh $(SMBDOTCONFDOC) > $@
-$(SMBDOTCONFDOC)/parameters.global.xml: $(SMBDOTCONFDOC)/parameters.all.xml
+$(SMBDOTCONFDOC)/parameters.global.xml: $(SMBDOTCONFDOC)/parameters.all.xml $(SMBDOTCONFDOC)/generate-context.xsl
$(XSLTPROC) --xinclude --param smb.context "'G'" --output $(SMBDOTCONFDOC)/parameters.global.xml $(SMBDOTCONFDOC)/generate-context.xsl $<
-$(SMBDOTCONFDOC)/parameters.service.xml: $(SMBDOTCONFDOC)/parameters.all.xml
+$(SMBDOTCONFDOC)/parameters.service.xml: $(SMBDOTCONFDOC)/parameters.all.xml $(SMBDOTCONFDOC)/generate-context.xsl
$(XSLTPROC) --xinclude --param smb.context "'S'" --output $(SMBDOTCONFDOC)/parameters.service.xml $(SMBDOTCONFDOC)/generate-context.xsl $<
$(MANDIR):
mkdir $(MANDIR)
-$(MANDIR)/%: %.xml
+$(MANDIR)/%: $(DOCBOOKDIR)/%.xml xslt/man.xsl
$(XSLTPROC) --output $@ xslt/man.xsl $<
+# Pearson compatible XML
+
$(PEARSONDIR):
mkdir $@
-$(PEARSONDIR)/%.xml: %.xml $(PEARSONDIR)
+$(PEARSONDIR)/%.xml: $(DOCBOOKDIR)/%.xml $(PEARSONDIR) xslt/pearson.xsl
$(XSLTPROC) --xinclude --output $@ xslt/pearson.xsl $<
$(PEARSONDIR)/%.report.html: $(PEARSONDIR)/%.xml
$(XMLLINT) --valid --noout --htmlout $< 2> $@
-pearson: $(PEARSONDIR)/Samba-HOWTO-Collection.xml
-pearson-verify: $(PEARSONDIR)/Samba-HOWTO-Collection.report.html
+# Validation verification
$(VALIDATEDIR):
mkdir $@
-$(VALIDATEDIR)/%.report.html: %.xml
+$(VALIDATEDIR)/%.report.html: $(DOCBOOKDIR)/%.xml
$(XMLLINT) --valid --noout --htmlout $< 2> $@
verify: $(VALIDATEDIR) $(VALIDATEDIR)/Samba-HOWTO-Collection.report.html $(VALIDATEDIR)/Samba-Developers-Guide.report.html $(VALIDATEDIR)/Samba-Guide.report.html
# Find undocumented parameters
-undocumented: $(SMBDOTCONFDOC)/parameters.all.xml
+undocumented: $(SMBDOTCONFDOC)/parameters.all.xml scripts/find_missing_doc.pl scripts/find_missing_manpages.pl
@$(PERL) scripts/find_missing_doc.pl $(SRCDIR)
@$(PERL) scripts/find_missing_manpages.pl $(SRCDIR)
$(EXAMPLESDIR):
mkdir $(EXAMPLESDIR)
-files: $(HOWTODIR)/index.xml $(HOWTODIR)/attributions.xml $(EXAMPLESDIR)
+files: $(HOWTODIR)/index.xml $(EXAMPLESDIR) xslt/extract-smbfiles.xsl
$(XSLTPROC) xslt/extract-smbfiles.xsl $< > /dev/null
-samples: $(EXAMPLESDIR) Samba-HOWTO-Collection.xml
- $(XSLTPROC) xslt/extract-examples.xsl Samba-HOWTO-Collection.xml > /dev/null 2> examples/README
+samples: $(DOCBOOKDIR)/Samba-HOWTO-Collection.xml $(EXAMPLESDIR) xslt/extract-examples.xsl scripts/indent-smb.conf.pl
+ $(XSLTPROC) --xinclude xslt/extract-examples.xsl $< > /dev/null 2> examples/README
for I in examples/*.conf; do { ./scripts/indent-smb.conf.pl < $$I > $$I.tmp; mv $$I.tmp $$I; } done
-howto: $(PDFDIR)/Samba-HOWTO-Collection.pdf
-guide: $(PDFDIR)/Samba-Guide.pdf
-
-%/changelog.xml: % $(wildcard %/CVS/*)
- touch $@
- # FIXME
+# Archiving
$(ARCHIVEDIR):
mkdir $(ARCHIVEDIR)
archive: $(ARCHIVEDIR) guide howto
cp $(PDFDIR)/Samba-HOWTO-Collection.pdf $(ARCHIVEDIR)/TOSHARG-`date +%Y%m%d`.pdf
cp $(PDFDIR)/Samba-Guide.pdf $(ARCHIVEDIR)/S3bE-`date +%Y%m%d`.pdf
+
+# XSL scripts
+xslt/html.xsl: xslt/html-common.xsl settings.xsl
+xslt/html-chunk.xsl: xslt/html-common.xsl settings.xsl
+xslt/latex.xsl: settings.xsl
+xslt/expand-sambadoc.xsl: settings.xsl
+xslt/generate-attributions.xsl:
+xslt/man.xsl:
+xslt/pearson.xsl:
<!ENTITY % global_entities SYSTEM '../entities/global.entities'>
%global_entities;
]>
+
<chapter id="gencache">
<chapterinfo>
<author>
</para>
<para><programlisting>
-key: <string&bt;
-value: <12-digit timeout&bt;/<string>
+key: <string>
+value: <12-digit timeout>/<string>
</programlisting></para>
<para>The timeout part is the ASCII representation of
</programlisting></para>
-<sect1>
-<title>Writing your own caching layer</title>
</sect1>
</chapter>
</abstract>
</bookinfo>
-<preface>
- <title>Attributions</title>
-
- <xi:include href="attributions.xml"/>
-</preface>
-
+<xi:include href="../Samba-Developers-Guide-attributions.xml"/>
<!-- Contents -->
<toc/>
A screenshot of a later stage of the same capture is shown in <link linkend="pktcap02"/>.
</para>
-<figure id="pktcap01">
- <title>Windows Me &smbmdash; Broadcasts &smbmdash; The First 10 Minutes</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/WINREPRESSME-Capture.png" scale="53" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/WINREPRESSME-Capture.png" scale="53" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
-
-<figure id="pktcap02">
- <title>Windows Me &smbmdash; Later Broadcast Sample</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/WINREPRESSME-Capture2.png" scale="57" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/WINREPRESSME-Capture2.png" scale="57" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="pktcap01">
+ <imagefile scale="53">WINREPRESSME-Capture.png</imagefile>
+ <description>Windows Me &smbmdash; Broadcasts &smbmdash; The First 10 Minutes</description>
+ </image>
+
+ <image id="pktcap02">
+ <description>Windows Me &smbmdash; Later Broadcast Sample</description>
+ <imagefile scale="57">WINREPRESSME-Capture2.png</imagefile>
+ </image>
<para><indexterm>
<primary>Local Master Browser</primary>
</sect3>
-<figure id="hostannounce">
- <title>Typical Windows 9x/Me Host Announcement</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/HostAnnouncment.png" scale="55" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/HostAnnouncment.png" scale="55" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="hostannounce">
+ <description>Typical Windows 9x/Me Host Announcement</description>
+ <imagefile scale="55">HostAnnouncment.png</imagefile>
+ </image>
</sect2>
<link linkend="nullconnect"/>.
</para>
-<figure id="nullconnect">
- <title>Typical Windows 9x/Me NULL SessionSetUp AndX Request</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/NullConnect.png" scale="65" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/NullConnect.png" scale="65" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="nullconnect">
+ <description>Typical Windows 9x/Me NULL SessionSetUp AndX Request</description>
+
+ <imagefile scale="65">NullConnect.png</imagefile>
+ </image>
<para>
<indexterm><primary>nobody</primary></indexterm>
is shown in <link linkend="userconnect"/>.
</para>
-<figure id="userconnect">
- <title>Typical Windows 9x/Me User SessionSetUp AndX Request</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/UserConnect.png" scale="65" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/UserConnect.png" scale="65" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="userconnect">
+ <description>Typical Windows 9x/Me User SessionSetUp AndX Request</description>
+ <imagefile scale="65">UserConnect.png</imagefile>
+ </image>
<para>
<indexterm><primary>encrypted</primary></indexterm>
</procedure>
-<figure id="XPCap01">
- <title>Typical Windows XP NULL Session Setup AndX Request</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/WindowsXP-NullConnection.png" scale="70" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/WindowsXP-NullConnection.png" scale="70" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
-
-<figure id="XPCap02">
- <title>Typical Windows XP User Session Setup AndX Request</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/WindowsXP-UserConnection.png" scale="70" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/WindowsXP-UserConnection.png" scale="70" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="XPCap01">
+ <description>Typical Windows XP NULL Session Setup AndX Request</description>
+ <imagefile scale="70">WindowsXP-NullConnection.png</imagefile>
+ </image>
+
+ <image id="XPCap02">
+ <description>Typical Windows XP User Session Setup AndX Request</description>
+ <imagefile scale="70">WindowsXP-UserConnection.png</imagefile>
+ </image>
<sect3>
<title>Discussion</title>
The office network is built as shown in <link linkend="charitynet"/>.
</para>
-<figure id="charitynet">
- <title>Charity Administration Office Network</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/Charity-Network.png" scale="100" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/Charity-Network.png" scale="100" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="charitynet">
+ <description>Charity Administration Office Network</description>
+ <imagefile scale="100">Charity-Network.png</imagefile>
+ </image>
<procedure>
<title>Samba Server Configuration</title>
start of Samba configuration. The following prescriptive steps may now commence.
</para>
- <figure id="acctingnet2">
- <title>Accounting Office Network Topology</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/AccountingNetwork.png" scale="100" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/AccountingNetwork.png" scale="100" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="acctingnet2">
+ <description>Accounting Office Network Topology</description>
+ <imagefile scale="100">AccountingNetwork.png</imagefile>
+ </image>
<table id="acctingnet">
<title>Accounting Office Network Information</title>
by setting the sticky bit (set UID/GID) on the top-level directories.
</para>
-<figure id="acct2net">
- <title>Abmas Accounting &smbmdash; 52 User Network Topology</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/acct2net.png" scale="100" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/acct2net.png" scale="100" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="acct2net">
+ <description>Abmas Accounting &smbmdash; 52 User Network Topology</description>
+ <imagefile scale="100">acct2net.png</imagefile>
+ </image>
<procedure>
<step><para>
</tgroup>
</table>
-<figure id="ch04net">
- <title>Abmas Network Topology &smbmdash; 130 Users</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/chap4-net.png" scale="90" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/chap4-net.png" scale="90" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="ch04net">
+ <description>Abmas Network Topology &smbmdash; 130 Users</description>
+ <imagefile scale="90">chap4-net.png</imagefile>
+ </image>
<para>
Christine has recommended that desktop systems should be installed from a single cloned
selected hardware that is appropriate to the task.
</para>
-<figure id="chap05net">
- <title>Network Topology &smbmdash; 500 User Network Using tdbsam passdb backend.</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/chap5-net.png" scale="80" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/chap5-net.png" scale="80" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="chap05net">
+ <description>Network Topology &smbmdash; 500 User Network Using tdbsam passdb backend.</description>
+ <imagefile scale="80">chap5-net.png</imagefile>
+ </image>
<sect2 id="ch5-dnshcp-setup">
<title>Installation of DHCP, DNS, and Samba Control Files</title>
of the UNIX username to the UID. The relationships are demonstrated in <link linkend="ch6-LDAPdiag"/>.
</para>
- <figure id="ch6-LDAPdiag">
- <title>The Interaction of LDAP, UNIX Posix Accounts and Samba Accounts</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/UNIX-Samba-and-LDAP.png" scale="70" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/UNIX-Samba-and-LDAP.png" scale="70" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="ch6-LDAPdiag">
+ <description>The Interaction of LDAP, UNIX Posix Accounts and Samba Accounts</description>
+ <imagefile scale="70">UNIX-Samba-and-LDAP.png</imagefile>
+ </image>
<para><indexterm>
<primary>security</primary>
that you will install additional file servers, and possibly additional BDCs.
</para>
-<figure id="chap6net">
- <title>Network Topology &smbmdash; 500 User Network Using ldapsam passdb backend.</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata scale="70" scalefit="1"
- fileref="guide/images/chap6-net.png"/>
- </imageobject>
- <imageobject>
- <imagedata scale="70" scalefit="1"
- fileref="guide/images/chap6-net.png"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="chap6net">
+ <description>Network Topology &smbmdash; 500 User Network Using ldapsam passdb backend.</description>
+ <imagefile scale="70">chap6-net.png</imagefile>
+ </image>
<para><indexterm>
<primary>SUSE Linux</primary>
</procedure>
-<figure id="XP-screen001">
- <title>Windows XP Professional &smbmdash; User Shared Folders</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata scale="65" scalefit="1"
- fileref="guide/images/XP-screen001.png"/>
- </imageobject>
- <imageobject>
- <imagedata scale="65" scalefit="1"
- fileref="guide/images/XP-screen001.png"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="XP-screen001">
+ <description>Windows XP Professional &smbmdash; User Shared Folders</description>
+ <imagefile scale="65">XP-screen001.png</imagefile>
+ </image>
<table id="proffold">
<title>Default Profile Redirections</title>
procedures for managing the directory, as retroactive correction of
inconsistent directory information can be exceedingly difficult.</para>
-<figure id="chap7net">
- <title>Network Topology &smbmdash; 2000 User Complex Design A</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata scale="80" scalefit="1"
- fileref="guide/images/chap7-net-Ar.png"/>
- </imageobject>
- <imageobject>
- <imagedata scale="80" scalefit="1"
- fileref="guide/images/chap7-net-Ar.png"/>
- </imageobject>
- </mediaobject>
-</figure>
-
-<figure id="chap7net2">
- <title>Network Topology &smbmdash; 2000 User Complex Design B</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata scale="80" scalefit="1"
- fileref="guide/images/chap7-net2-Br.png"/>
- </imageobject>
- <imageobject>
- <imagedata scale="80" scalefit="1"
- fileref="guide/images/chap7-net2-Br.png"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="chap7net">
+ <description>Network Topology &smbmdash; 2000 User Complex Design A</description>
+ <imagefile scale="80">chap7-net-Ar.png</imagefile>
+ </image>
+
+ <image id="chap7net2">
+ <description>Network Topology &smbmdash; 2000 User Complex Design B</description>
+ <imagefile scale="80">chap7-net2-Br.png</imagefile>
+ </image>
</sect3>
(obtaining a UNIX UID/GID) using the specific systems shown.
</para>
-<figure id="chap7idres">
- <title>Samba and Authentication Backend Search Pathways</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata scale="80" scalefit="1"
- fileref="guide/images/chap7-idresol.png"/>
- </imageobject>
- <imageobject>
- <imagedata scale="80" scalefit="1"
- fileref="guide/images/chap7-idresol.png"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="chap7idres">
+ <description>Samba and Authentication Backend Search Pathways</description>
+ <imagefile scale="80">chap7-idresol.png</imagefile>
+ </image>
<para><indexterm>
<primary>smbpasswd</primary>
</screen>
This configuration tells Samba to use a single LDAP server as shown in
<link linkend="ch7singleLDAP"/>.
- <figure id="ch7singleLDAP">
- <title>Samba Configuration to Use a Single LDAP Server</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/ch7-singleLDAP.png" scale="100" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/ch7-singleLDAP.png" scale="100" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="ch7singleLDAP">
+ <description>Samba Configuration to Use a Single LDAP Server</description>
+ <imagefile scale="100">ch7-singleLDAP.png</imagefile>
+ </image>
<indexterm>
<primary>LDAP</primary>
<secondary>fail-over</secondary>
</screen>
This configuration tells Samba to use a master LDAP server, with fail-over to a slave server if necessary,
as shown in <link linkend="ch7dualLDAP"/>.
- <figure id="ch7dualLDAP">
- <title>Samba Configuration to Use a Dual (Fail-over) LDAP Server</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/ch7-fail-overLDAP.png" scale="100" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/ch7-fail-overLDAP.png" scale="100" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="ch7dualLDAP">
+ <description>Samba Configuration to Use a Dual (Fail-over) LDAP Server</description>
+ <imagefile scale="100">ch7-fail-overLDAP.png</imagefile>
+ </image>
</para>
<para>Some folks have tried to implement this without the use of
configuration is shown in <link linkend="ch7dualadd"/>
</para>
- <figure id="ch7dualadd">
- <title>Samba Configuration to Use Dual LDAP Databases - Broken - Do Not Use!</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/ch7-dual-additive-LDAP.png" scale="80" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/ch7-dual-additive-LDAP.png" scale="80" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="ch7dualadd">
+ <description>Samba Configuration to Use Dual LDAP Databases - Broken - Do Not Use!</description>
+ <imagefile scale="80">ch7-dual-additive-LDAP.png</imagefile>
+ </image>
<para>
If, however, each LDAP database contains unique information, this may
An example of this configuration is shown in <link linkend="ch7dualok"/>.
</para>
- <figure id="ch7dualok">
- <title>Samba Configuration to Use Two LDAP Databases - The result is additive.</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/ch7-dual-additive-LDAP-Ok.png" scale="80" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/ch7-dual-additive-LDAP-Ok.png" scale="80" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="ch7dualok">
+ <description>Samba Configuration to Use Two LDAP Databases - The result is additive.</description>
+ <imagefile scale="80">ch7-dual-additive-LDAP-Ok.png</imagefile>
+ </image>
<note><para>
When the use of ldapsam is specified twice, as shown here, it is imperative
from a Windows NT4 Domain to a Samba Domain.
</para>
- <figure id="ch8-migration">
- <title>Schematic Explaining the <command>net rpc vampire</command> Process</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/ch8-migration.png" scale="80" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/ch8-migration.png" scale="80" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="ch8-migration">
+ <description>Schematic Explaining the <command>net rpc vampire</command> Process</description>
+ <imagefile scale="80">ch8-migration.png</imagefile>
+ </image>
<para>
In any case, the migration process involves the following steps:
an LDAP backend.
</para>
- <figure id="NT4DUM">
- <title>View of Accounts in NT4 Domain User Manager</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/UserMgrNT4.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/UserMgrNT4.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="NT4DUM">
+ <description>View of Accounts in NT4 Domain User Manager</description>
+ <imagefile scale="50">UserMgrNT4.png</imagefile>
+ </image>
</sect2>
<link linkend="ch09openmag"/>.
</para>
-<figure id="ch09openmag">
- <title>Open Magazine Samba Survey</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/openmag.png" scale="60" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/openmag.png" scale="60" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="ch09openmag">
+ <description>Open Magazine Samba Survey</description>
+ <imagefile scale="60">openmag.png</imagefile>
+ </image>
<para>
While Domain Control is an exciting subject, basic file and print sharing remains the staple bread-and-butter
Member server within a Samba Domain Control network.
</para>
-<figure id="ch9-sambadc">
- <title>Samba Domain: Samba Member Server</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/chap9-SambaDC.png" scale="75" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/chap9-SambaDC.png" scale="75" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+<image id="ch9-sambadc">
+ <description>Samba Domain: Samba Member Server</description>
+ <imagefile scale="75">chap9-SambaDC.png</imagefile>
+</image>
<para><indexterm>
<primary>IDMAP</primary>
Domain Name is <constant>LONDON</constant> and the server name is <constant>W2K3S</constant>.
</para>
-<figure id="ch9-adsdc">
- <title>Active Directory Domain: Samba Member Server</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/chap9-ADSDC.png" scale="75" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/chap9-SambaDC.png" scale="75" scalefit="1"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <image id="ch9-adsdc">
+ <description>Active Directory Domain: Samba Member Server</description>
+ <imagefile scale="75">chap9-ADSDC.png</imagefile>
+ </image>
<procedure>
<step><para><indexterm>
An example of the LAM login screen is provided in <link linkend="lam-login"/>.
</para>
- <figure id="lam-login">
- <title>The LDAP Account Manager Login Screen</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/lam-login.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/lam-login.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="lam-login">
+ <description>The LDAP Account Manager Login Screen</description>
+ <imagefile scale="50">lam-login.png</imagefile>
+ </image>
<para><indexterm>
<primary>LAM</primary>
using LAM to add additional users and groups.
</para>
- <figure id="lam-config">
- <title>The LDAP Account Manager Configuration Screen</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/lam-config.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/lam-config.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="lam-config">
+ <description>The LDAP Account Manager Configuration Screen</description>
+ <imagefile scale="50">lam-config.png</imagefile>
+ </image>
<para><indexterm>
<primary>PDF</primary>
finished editing simply press the <guimenu>Final</guimenu> button.
</para>
- <figure id="lam-user">
- <title>The LDAP Account Manager User Edit Screen</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/lam-users.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/lam-users.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="lam-user">
+ <description>The LDAP Account Manager User Edit Screen</description>
+ <imagefile scale="50">lam-users.png</imagefile>
+ </image>
<para>
The edit screen for groups is shown in <link linkend="lam-group"/>. As with the edit screen
memberships.
</para>
- <figure id="lam-group">
- <title>The LDAP Account Manager Group Edit Screen</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/lam-groups.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/lam-groups.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <figure id="lam-group-mem">
- <title>The LDAP Account Manager Group Membership Edit Screen</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/lam-group-members.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/lam-group-members.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="lam-group">
+ <description>The LDAP Account Manager Group Edit Screen</description>
+ <imagefile scale="50">lam-groups.png</imagefile>
+ </image>
+
+ <image id="lam-group-mem">
+ <description>The LDAP Account Manager Group Membership Edit Screen</description>
+ <imagefile scale="50">lam-group-members.png</imagefile>
+ </image>
<para><indexterm>
<primary>smbldap-tools</primary>
will, in most cases, not be used.
</para>
- <figure id="lam-host">
- <title>The LDAP Account Manager Host Edit Screen</title>
- <mediaobject>
- <imageobject role="latex">
- <imagedata fileref="guide/images/lam-hosts.png" scale="50" scalefit="1"/>
- </imageobject>
- <imageobject>
- <imagedata fileref="guide/images/lam-hosts.png" scale="50" scalefit="1"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <image id="lam-host">
+ <description>The LDAP Account Manager Host Edit Screen</description>
+ <imagefile scale="50">lam-hosts.png</imagefile>
+ </image>
<para>
One aspect of LAM that may annoy some users is the way it forces certain conventions on
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+ <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
+ %global_entities;
+]>
+
<chapter id="Further-Resources">
<chapterinfo>
&author.jelmer;
<?latex \setcounter{page}{5} ?>
-<preface>
- <title>Attribution</title>
- <para>
- <xi:include href="attributions.xml"/>
- </para>
-</preface>
+<xi:include href="../Samba-HOWTO-Collection-attributions.xml"/>
<?latex \cleardoublepage ?>
</div>
<hr>
<table>
- <td valign="top">SAMBA <a href="devel/index.html">Developers</a> Guide</td>
+ <td valign="top">SAMBA <a href="Samba-Developers-Guide/index.html">Developers</a> Guide</td>
<td valign="top">This book is a collection of documents that might be useful for people developing samba or those interested in doing so. It's nothing more than a collection of documents written by samba developers about the internals of various parts of samba and the SMB protocol. It's still (and will always be) incomplete.</td>
</tr>
<tr>
- <td valign="top">Samba-3 by <a href="guide/index.html">Examples</a></td>
+<td valign="top">Samba-3 by <a href="Samba-Guide/index.html">Example</a></td>
<td valign="top">Practical Exercises in Successful Samba Deployment.</td>
</tr>
<tr>
- <td valign="top">The Official Samba-3 <a href="howto/index.html">HOWTO</a> and Reference Guide</td>
+ <td valign="top">The Official Samba-3 <a href="Samba-HOWTO-Collection/index.html">HOWTO</a> and Reference Guide</td>
<td valign="top">This book provides example configurations, it documents key aspects of Microsoft Windows networking, provides in-depth insight into the important configuration of Samba-3, and helps to put all of these into a useful framework.</td>
</tr>
<tr>
<xsl:attribute name="role"><xsl:text>latex</xsl:text></xsl:attribute>
<xsl:element name="imagedata">
<xsl:attribute name="fileref">
- <xsl:text>howto/imagefiles/</xsl:text><xsl:value-of select="imagefile"/></xsl:attribute>
+ <xsl:value-of select="$imagedir"/><xsl:value-of select="imagefile"/></xsl:attribute>
<xsl:attribute name="scale">
<xsl:choose>
<xsl:when test="@scale != ''">
<xsl:apply-templates select="@*|node()"/>
</xsl:template>
+<xsl:template match="/">
+ <xsl:element name="preface">
+ <xsl:element name="title"><xsl:text>Attribution</xsl:text></xsl:element>
+ <xsl:element name="para">
+ <xsl:apply-templates/>
+ </xsl:element>
+ </xsl:element>
+</xsl:template>
+
<xsl:template match="chapter">
<xsl:choose>
<xsl:when test="chapterinfo/author != ''">
<xsl:variable name="latex.documentclass.book"></xsl:variable>
<xsl:variable name="latex.hyperref.param.pdftex">hyperfigures,hyperindex,citecolor=black,urlcolor=black,filecolor=black,linkcolor=black,menucolor=red,pagecolor=black</xsl:variable>
<xsl:variable name="latex.document.font">default</xsl:variable>
-<xsl:variable name="latex.admonition.path">xslt/figures</xsl:variable>
+<xsl:variable name="admon.graphics.path">xslt/figures</xsl:variable>
<xsl:variable name="latex.use.tabularx">1</xsl:variable>
<xsl:variable name="latex.fancyhdr.lh"></xsl:variable>
<xsl:variable name="latex.use.fancyhdr"></xsl:variable>