@echo " htmlman3,htmlman4 - Build HTML version of manpages"
@echo " undocumented - Output list of undocumented smb.conf options"
@echo " samples - Extract examples"
- @echo " files - Extract other files"
$(DOCBOOKDIR)/Samba3-ByExample.xml: $(filter-out Samba3-ByExample/index.xml,$(wildcard Samba3-ByExample/*.xml))
$(DOCBOOKDIR)/Samba3-HOWTO.xml: $(filter-out Samba3-HOWTO/index.xml,$(wildcard Samba3-HOWTO/*.xml)) Samba3-HOWTO-attributions.xml
@$(PERL) scripts/find_missing_doc.pl $(SRCDIR)
@$(PERL) scripts/find_missing_manpages.pl $(SRCDIR)
-# Examples and the like
-files: Samba3-HOWTO/index.xml xslt/extract-smbfiles.xsl
- $(XSLTPROC) xslt/extract-smbfiles.xsl $< > /dev/null
-
samples: $(DOCBOOKDIR)/Samba3-HOWTO.xml xslt/extract-examples.xsl scripts/indent-smb.conf.pl
mkdir -p $(EXAMPLESDIR)
$(XSLTPROC) --xinclude xslt/extract-examples.xsl $< > /dev/null 2> examples/README
An overview of the permissions field can be found in <link linkend="access1">Overview of UNIX permissions field</link>.
</para>
- <image id="access1"><imagedescription>Overview of UNIX permissions field.</imagedescription>
- <imagefile scale="40">access1</imagefile></image>
+ <figure id="access1">
+ <title>Overview of UNIX permissions field.</title>
+ <imagefile scale="40">access1</imagefile>
+ </figure>
<para>
Any bit flag may be unset. An unset bit flag is the equivalent of <quote>cannot</quote> and is represented
<indexterm><primary>genlogon.pl</primary></indexterm>
This is the <filename>genlogon.pl</filename> file:
-<smbfile name="genlogon.pl">
<programlisting>
#!/usr/bin/perl
#
# All done! Close the output file.
close LOGON;
</programlisting>
-</smbfile>
</para>
<para>
<para>
- <image>
- <imagedescription>Windows printing to a local printer.</imagedescription>
+ <figure>
+ <title>Windows printing to a local printer.</title>
<imagefile>1small</imagefile>
- </image>
+ </figure>
</para>
</sect2>
</note>
<para>
- <image>
- <imagedescription>Printing to a PostScript printer.</imagedescription>
+ <figure>
+ <title>Printing to a PostScript printer.</title>
<imagefile>2small</imagefile>
- </image>
+ </figure>
</para>
</para>
<para>
- <image><imagedescription>Ghostscript as a RIP for non-postscript printers.</imagedescription>
- <imagefile>3small</imagefile>
- </image>
+ <figure>
+ <title>Ghostscript as a RIP for non-postscript printers.</title>
+ <imagefile>3small</imagefile>
+ </figure>
</para>
<tip><para>
</para>
<para>
- <image>
- <imagedescription>Pre-filtering in CUPS to form PostScript.</imagedescription>
+ <figure>
+ <title>Pre-filtering in CUPS to form PostScript.</title>
<imagefile scale="25">4small</imagefile>
- </image>
+ </figure>
</para>
</sect2>
</para>
<para>
- <image><imagedescription>Adding device-specific print options.</imagedescription>
+ <figure>
+ <title>Adding device-specific print options.</title>
<imagefile scale="25">5small</imagefile>
- </image>
+ </figure>
</para>
<para>
</para>
<para>
- <image>
- <imagedescription>PostScript to intermediate raster format.</imagedescription>
+ <figure>
+ <title>PostScript to intermediate raster format.</title>
<imagefile scale="25">6small</imagefile>
- </image>
+ </figure>
</para>
<para>
</para>
<para>
- <image>
- <imagedescription>CUPS-raster production using Ghostscript.</imagedescription>
+ <figure>
+ <title>CUPS-raster production using Ghostscript.</title>
<imagefile>7small</imagefile>
- </image>
+ </figure>
</para>
<para>
</para>
<para>
- <image id="small8">
- <imagedescription>Image format to CUPS-raster format conversion.</imagedescription>
+ <figure id="small8">
+ <title>Image format to CUPS-raster format conversion.</title>
<imagefile>8small</imagefile>
- </image>
+ </figure>
</para>
</sect2>
</para>
<para>
- <image id="small9">
- <imagedescription>Raster to printer-specific formats.</imagedescription>
+ <figure id="small9">
+ <title>Raster to printer-specific formats.</title>
<imagefile>9small</imagefile>
- </image>
+ </figure>
</para>
</sect2>
</para>
<para>
- <image id="cupsomatic-dia">
- <imagedescription>cupsomatic/foomatic Processing versus Native CUPS.</imagedescription>
+ <figure id="cupsomatic-dia">
+ <title>cupsomatic/foomatic Processing versus Native CUPS.</title>
<imagefile>10small</imagefile>
- </image>
+ </figure>
</para>
<para>
<para>
The resulting filter chain, therefore, is as drawn in <link linkend="pdftosocket">PDF to socket chain</link>.
- <image id="pdftosocket">
- <imagedescription>PDF to socket chain.</imagedescription>
+ <figure id="pdftosocket">
+ <title>PDF to socket chain.</title>
<imagefile>pdftosocket</imagefile>
- </image>
+ </figure>
</para>
The resulting filter chain therefore is as drawn in <link linkend="pdftoepsonusb">this figure</link>.
</para>
-<image id="pdftoepsonusb">
- <imagedescription>PDF to USB chain.</imagedescription>
+<figure id="pdftoepsonusb">
+ <title>PDF to USB chain.</title>
<imagefile>pdftoepsonusb</imagefile>
-</image>
+</figure>
</sect2>
<sect2>
</para>
<para>
- <image id="small11">
- <imagedescription>Print driver execution on the client.</imagedescription>
+ <figure id="small11">
+ <title>Print driver execution on the client.</title>
<imagefile>11small</imagefile>
- </image>
+ </figure>
</para>
</sect2>
</para>
<para>
- <image id="small12">
- <imagedescription>Print driver execution on the server.</imagedescription>
+ <figure id="small12">
+ <title>Print driver execution on the server.</title>
<imagefile>12small</imagefile>
- </image>
+ </figure>
</para>
<para>
</para>
<para>
- <image>
- <imagedescription>Printing via CUPS/Samba server.</imagedescription>
+ <figure>
+ <title>Printing via CUPS/Samba server.</title>
<imagefile>13small</imagefile>
- </image>
+ </figure>
</para>
</sect2>
</para>
<para>
- <image id="small14">
- <imagedescription>cupsaddsmb flowchart.</imagedescription>
- <imagefile>14small</imagefile></image>
+ <figure id="small14">
+ <title>cupsaddsmb flowchart.</title>
+ <imagefile>14small</imagefile></figure>
</para>
</sect2>
The following diagrams reveal how CUPS handles print jobs.
</para>
-<image id="cups1">
- <imagedescription>Filtering chain 1.</imagedescription>
+<figure id="cups1">
+ <title>Filtering chain 1.</title>
<imagefile>cups1</imagefile>
-</image>
+</figure>
-<image id="cups2">
- <imagedescription>Filtering chain with cupsomatic</imagedescription>
+<figure id="cups2">
+ <title>Filtering chain with cupsomatic</title>
<imagefile>cups2</imagefile>
-</image>
+</figure>
</sect1>
<para>A complete overview of the CUPS printing processes can be found in <link linkend="a_small">the next flowchart</link>.</para>
-<image id="a_small">
- <imagedescription>CUPS printing overview.</imagedescription>
+<figure id="a_small">
+ <title>CUPS printing overview.</title>
<imagefile>a_small</imagefile>
-</image>
+</figure>
</sect1>
</chapter>
like this one, perhaps calling it <filename>startsmb</filename>.
</para>
-<smbfile name="startsmb.sh">
<para><programlisting>
#!/bin/sh
/usr/local/samba/bin/smbd -D
/usr/local/samba/bin/winbindd
/usr/local/samba/bin/nmbd -D
</programlisting></para>
-</smbfile>
<para>
Make it executable with <command>chmod +x startsmb</command>
determines the location of all further configuration files used.
The location and name of this file is specified in the start-up script
that is part of the operating system.
- <smbfile name="named.conf">
<programlisting>
# Quenya.Org configuration file
};
};
</programlisting>
-</smbfile>
</para>
<para>
The following files are all located in the directory <filename>/var/named</filename>.
This is the <filename>/var/named/localhost.zone</filename> file:
- <smbfile name="localhost.zone">
<programlisting>
$TTL 1W
@ IN SOA @ root (
IN NS @
IN A 127.0.0.1
</programlisting>
-</smbfile>
</para>
<para>
The <filename>/var/named/127.0.0.zone</filename> file:
- <smbfile name="127.0.0.0.zone">
<programlisting>
$TTL 1W
@ IN SOA localhost. root.localhost. (
IN NS localhost.
1 IN PTR localhost.
</programlisting>
-</smbfile>
</para>
<para>
The <filename>/var/named/quenya.org.host</filename> file:
- <smbfile name="quenya.org.host">
<programlisting>
$ORIGIN .
$TTL 38400 ; 10 hours 40 minutes
mail CNAME marvel
www CNAME marvel
</programlisting>
-</smbfile>
</para>
<para>
The <filename>/var/named/192.168.1.0.rev</filename> file:
- <smbfile name="192.168.1.0.rev">
<programlisting>
$ORIGIN .
$TTL 38400 ; 10 hours 40 minutes
1 PTR frodo.quenya.org.
2 PTR marvel.quenya.org.
</programlisting>
-</smbfile>
</para>
<para>
</para>
<para>
- <smbfile name="dhcpd.conf">
<programlisting>
ddns-updates on;
ddns-domainname "quenya.org";
allow unknown-clients;
}
</programlisting>
-</smbfile>
</para>
<para>
</para>
<para>
- <smbfile name="krb5.conf">
<programlisting>
[libdefaults]
default_realm = YOUR.KERBEROS.REALM
[domain_realms]
.kerberos.server = YOUR.KERBEROS.REALM
-</programlisting></smbfile></para>
+</programlisting></para>
<para>
When using Heimdal versions before 0.6 use the following configuration settings:
Assign each of the UNIX groups to NT groups:
(It may be useful to copy this text to a shell script called
<filename>initGroups.sh</filename>.)
- <smbfile name="initGroups.sh">
<title>Shell script for initializing group mappings</title>
<programlisting>
#!/bin/bash
net groupmap add ntgroup="Engineers" unixgroup=engineers type=d
net groupmap add ntgroup="QA Team" unixgroup=qateam type=d
</programlisting>
-</smbfile>
</para></step>
<step><para>
Set up the LDAP server. This example is suitable for OpenLDAP 2.1.x.
The <filename>/etc/openldap/slapd.conf</filename> file:
<indexterm><primary>/etc/openldap/slapd.conf</primary></indexterm>
-<smbfile name="slapd.conf"><title>Example slapd.conf file</title>
+<title>Example slapd.conf file</title>
<programlisting>
# Note commented out lines have been removed
include /etc/openldap/schema/core.schema
index sambaDomainName eq
index default sub
</programlisting>
-</smbfile>
</para></step>
<step><para>
Create the following file <filename>samba-ldap-init.ldif</filename>:
<indexterm><primary>samba-ldap-init.ldif</primary></indexterm>
- <smbfile name="samba-ldap-init.ldif">
<programlisting>
# Organization for SambaXP Demo
dn: dc=quenya,dc=org
userPassword: {SSHA}0jBHgQ1vp4EDX2rEMMfIudvRMJoGwjVb
# The password for above is 'mordonL8'
</programlisting>
-</smbfile>
</para></step>
<step><para>
parameters in the &smb.conf; file.
</para>
- <image id="idmap-sid2gid">
- <imagedescription>IDMAP: group SID to GID resolution.</imagedescription>
+ <figure id="idmap-sid2gid">
+ <title>IDMAP: group SID to GID resolution.</title>
<imagefile scale="50">idmap-sid2gid</imagefile>
- </image>
+ </figure>
- <image id="idmap-gid2sid">
- <imagedescription>IDMAP: GID resolution to matching SID.</imagedescription>
+ <figure id="idmap-gid2sid">
+ <title>IDMAP: GID resolution to matching SID.</title>
<imagefile scale="50">idmap-gid2sid</imagefile>
- </image>
+ </figure>
<para>
<indexterm><primary>IDMAP</primary></indexterm>
used to establish UNIX group to NT SID mappings as shown in <link linkend="idmap-store-gid2sid">IDMAP: storing group mappings</link>.
</para>
- <image id="idmap-store-gid2sid">
- <imagedescription>IDMAP storing group mappings.</imagedescription>
+ <figure id="idmap-store-gid2sid">
+ <title>IDMAP storing group mappings.</title>
<imagefile scale="50">idmap-store-gid2sid</imagefile>
- </image>
+ </figure>
<para>
<indexterm><primary>groupadd</primary></indexterm>
DomA and DomB), the following facilities are created:
</para>
-<image id="trusts1">
- <imagedescription>Trusts overview.</imagedescription>
+<figure id="trusts1">
+ <title>Trusts overview.</title>
<imagefile>trusts1</imagefile>
-</image>
+</figure>
<itemizedlist>
<listitem><para>
<indexterm><primary>initGroups.sh</primary></indexterm>
Now assign each of the UNIX groups to NT groups:
(It may be useful to copy this text to a script called <filename>initGroups.sh</filename>)
- <smbfile name="initGroups.sh">
<programlisting>
#!/bin/bash
#### Keep this as a shell script for future re-use
net groupmap add ntgroup="Engineers" unixgroup=engineers type=d rid=3210
net groupmap add ntgroup="QA Team" unixgroup=qateam type=d rid=3220
</programlisting>
-</smbfile>
</para></step>
<step><para><userinput>net groupmap list</userinput></para>
Consider a network set up as in <link linkend="browsing1">Cross-Subnet Browsing Example</link>.
</para>
-<image id="browsing1">
- <imagedescription>Cross-Subnet Browsing Example.</imagedescription>
+<figure id="browsing1">
+ <title>Cross-Subnet Browsing Example.</title>
<imagefile scale="40">browsing1</imagefile>
-</image>
+</figure>
<para>
This consists of 3 subnets (1, 2, 3) connected by two routers
<title>PAM: Original Login Config</title>
<para>
- <smbfile name="pam-login-default">
<programlisting>
#%PAM-1.0
# The PAM configuration file for the <quote>login</quote> service
# password required pam_cracklib.so retry=3
password required pam_pwdb.so shadow md5
</programlisting>
-</smbfile></para>
+</para>
</sect3>
</para>
<para>
- <smbfile name="pam-login-smbpass">
<programlisting>
#%PAM-1.0
# The PAM configuration file for the <quote>login</quote> service
account required pam_smbpass.so nodelay
session required pam_smbpass.so nodelay
password required pam_smbpass.so nodelay
-</programlisting></smbfile></para>
+</programlisting></para>
<para>
The following is the PAM configuration file for a particular
</para>
<para>
- <smbfile name="pam-samba-default">
<programlisting>
#%PAM-1.0
# The PAM configuration file for the <quote>samba</quote> service
account required pam_pwdb.so audit nodelay
session required pam_pwdb.so nodelay
password required pam_pwdb.so shadow md5
-</programlisting></smbfile></para>
+</programlisting></para>
<para>
In the following example, the decision has been made to use the
<command>passwd</command> program:
</para>
-<para><smbfile name="pam-samba-smbpass">
+<para>
<programlisting>
#%PAM-1.0
# The PAM configuration file for the <quote>samba</quote> service
session required pam_pwdb.so nodelay
password required pam_smbpass.so nodelay smbconf=/etc/samba.d/smb.conf
</programlisting>
-</smbfile></para>
+</para>
<note><para>PAM allows stacking of authentication mechanisms. It is
also possible to pass information obtained within one PAM module through
</para>
<para>
- <smbfile name="pam-synchronised-password">
<programlisting>
#%PAM-1.0
# password-sync
password requisite pam_unix.so shadow md5 use_authtok try_first_pass
password required pam_smbpass.so nullok use_authtok try_first_pass
session required pam_unix.so
-</programlisting></smbfile></para>
+</programlisting></para>
</sect3>
<sect3>
their mail, and so on.
</para>
-<para><smbfile name="pam-password-migration">
+<para>
<programlisting>
#%PAM-1.0
# password-migration
password requisite pam_unix.so shadow md5 use_authtok try_first_pass
password optional pam_smbpass.so nullok use_authtok try_first_pass
session required pam_unix.so
-</programlisting></smbfile></para>
+</programlisting></para>
</sect3>
<sect3>
the SMB password does not exist or does not match the UNIX password.
</para>
-<para><smbfile name="pam-fallback">
+<para>
<programlisting>
#%PAM-1.0
# password-mature
password requisite pam_unix.so shadow md5 use_authtok try_first_pass
password required pam_smbpass.so use_authtok use_first_pass
session required pam_unix.so
-</programlisting></smbfile></para>
+</programlisting></para>
</sect3>
<sect3>
a Kerberos realm.
</para>
-<para><smbfile name="pam-krb">
+<para>
<programlisting>
#%PAM-1.0
# kdc-pdc
password optional pam_smbpass.so nullok use_authtok try_first_pass
password required pam_krb5.so use_authtok try_first_pass
session required pam_krb5.so
-</programlisting></smbfile></para>
+</programlisting></para>
</sect3>
</para>
<para>
- <smbfile name="pam-winbind-erratic">
<programlisting>
auth required /lib/security/pam_securetty.so
auth sufficient /lib/security/pam_winbind.so
account required /lib/security/pam_stack.so service=system-auth
account required /lib/security/pam_winbind.so
password required /lib/security/pam_stack.so service=system-auth
-</programlisting></smbfile>
+</programlisting>
</para>
<para>
network clients.
</para>
-<image id="domain-example">
- <imagedescription>An Example Domain.</imagedescription>
+<figure id="domain-example">
+ <title>An Example Domain.</title>
<imagefile scale="50">domain</imagefile>
-</image>
+</figure>
<?latex \newpage ?>
</para>
- <image id="idmap-sid2uid">
- <imagedescription>IDMAP: Resolution of SIDs to UIDs.</imagedescription>
+ <figure id="idmap-sid2uid">
+ <title>IDMAP: Resolution of SIDs to UIDs.</title>
<imagefile scale="50">idmap-sid2uid</imagefile>
- </image>
+ </figure>
<para>
<indexterm><primary>SID</primary></indexterm>
<link linkend="idmap-uid2sid">resolution of UIDs to SIDs</link> diagrams.
</para>
- <image id="idmap-uid2sid">
- <imagedescription>IDMAP: Resolution of UIDs to SIDs.</imagedescription>
+ <figure id="idmap-uid2sid">
+ <title>IDMAP: Resolution of UIDs to SIDs.</title>
<imagefile scale="50">idmap-uid2sid</imagefile>
- </image>
+ </figure>
<sect2>
<title>Important Notes About Security</title>
</para>
<para>
- <smbfile name="samba.ldif.example">
<programlisting>
# Organization for Samba Base
dn: dc=quenya,dc=org
objectclass: simpleSecurityObject
userPassword: {SSHA}c3ZM9tBaBo9autm1dL3waDS21+JSfQVz
</programlisting>
-</smbfile>
</para>
<para>
</para>
<para>
- <smbfile name="samba.ldif.example2">
<programlisting>
dn: uid=guest2, ou=People,dc=quenya,dc=org
sambaLMPassword: 878D8014606CDA29677A44EFA1353FC7
sambaSID: S-1-5-21-2447931902-1787058256-3961074038-5006
sambaPwdCanChange: 0
</programlisting>
-</smbfile>
</para>
<para>
</para>
<para>
- <smbfile name="samba.ldif.example3">
<programlisting>
dn: uid=gcarter, ou=People,dc=quenya,dc=org
sambaLogonTime: 0
sambaPwdMustChange: 2147483647
sambaNTPassword: 878D8014606CDA29677A44EFA1353FC7
</programlisting>
-</smbfile>
</para>
</sect3>
<para>For details on the use of <command>ethereal</command>, read the well-written
Ethereal User Guide.</para>
-<image id="ethereal1"><imagedescription>Starting a capture.</imagedescription><imagefile>ethereal1</imagefile></image>
+<figure id="ethereal1"><title>Starting a capture.</title><imagefile>ethereal1</imagefile></figure>
<para>Listen for data on ports 137, 138, 139, and 445. For example, use
the filter <userinput>port 137, port 138, port 139, or port
<para>A console version of ethereal is available as well and is called
<command>tethereal</command>.</para>
-<image id="ethereal2"><imagedescription>Main ethereal data window.</imagedescription><imagefile>ethereal2</imagefile></image>
+<figure id="ethereal2"><title>Main ethereal data window.</title><imagefile>ethereal2</imagefile></figure>
</sect2>
</para>
<para>
- <smbfile name="xinetd.swat">
<programlisting>
# default: off
# description: SWAT is the Samba Web Admin Tool. Use swat \
disable = no
}
</programlisting>
-</smbfile>
In the above, the default setting for <parameter>disable</parameter> is <constant>yes</constant>.
This means that SWAT is disabled. To enable use of SWAT, set this parameter to <constant>no</constant>
as shown.
</para></note>
- <image id="winbind_idmap">
- <imagedescription>Winbind Idmap</imagedescription>
+ <figure id="winbind_idmap">
+ <title>Winbind Idmap</title>
<imagefile scale="50">idmap_winbind_no_loop</imagefile>
- </image>
+ </figure>
</sect1>
</para>
<para>
- <smbfile name="samba.server.sh">
<programlisting>
##
## samba.server
echo "Usage: /etc/init.d/samba.server { start | stop }"
;;
esac
-</programlisting></smbfile></para>
+</programlisting></para>
<para>
Again, if you would like to run Samba in dual daemon mode, replace:
changed to look like this:
</para>
-<para><smbfile name="pam.ftp.winbind"><programlisting>
+<para><programlisting>
auth required /lib/security/pam_listfile.so item=user sense=deny \
file=/etc/ftpusers onerr=succeed
auth sufficient /lib/security/pam_winbind.so
account sufficient /lib/security/pam_winbind.so
account required /lib/security/pam_stack.so service=system-auth
session required /lib/security/pam_stack.so service=system-auth
-</programlisting></smbfile></para>
+</programlisting></para>
<para>
The <filename>/etc/pam.d/login</filename> file can be changed nearly the
same way. It now looks like this:
</para>
-<para><smbfile name="pam.login.winbind"><programlisting>
+<para><programlisting>
auth required /lib/security/pam_securetty.so
auth sufficient /lib/security/pam_winbind.so
auth sufficient /lib/security/pam_unix.so use_first_pass
password required /lib/security/pam_stack.so service=system-auth
session required /lib/security/pam_stack.so service=system-auth
session optional /lib/security/pam_console.so
-</programlisting></smbfile></para>
+</programlisting></para>
<para>
In this case, I added the <programlisting>auth sufficient /lib/security/pam_winbind.so</programlisting>
On some installations the interface will be called <guimenu>Local Area Connection</guimenu> and
on others it will be called <guimenu>Network Bridge</guimenu>. On our system it is called <guimenu>Network Bridge</guimenu>.
Right click on <guimenu>Network Bridge -> Properties</guimenu>. See <link linkend="WXPP002"/>.
- <image id="WXPP002"><imagedescription>Network Bridge Configuration.</imagedescription><imagefile>WXPP002</imagefile></image>
+ <figure id="WXPP002"><title>Network Bridge Configuration.</title><imagefile>WXPP002</imagefile></figure>
</para>
</step>
<para>
The default setting is DHCP enabled operation.
(i.e., <quote>Obtain an IP address automatically</quote>). See <link linkend="WXPP003"/>.
- <image id="WXPP003">
- <imagedescription>Internet Protocol (TCP/IP) Properties.</imagedescription>
+ <figure id="WXPP003">
+ <title>Internet Protocol (TCP/IP) Properties.</title>
<imagefile>WXPP003</imagefile>
- </image>
+ </figure>
</para>
<para>
The technical name for the additional addresses is <emphasis>IP Aliases</emphasis>, and additionally this
panel permits the setting of more default gateways (routers). In most cases where DHCP is used, it will not be
necessary to create additional settings. See <link linkend="WXPP005"></link> to see the appearance of this panel.
- <image id="WXPP005"><imagedescription>Advanced Network Settings</imagedescription><imagefile>WXPP005</imagefile></image>
+ <figure id="WXPP005"><title>Advanced Network Settings</title><imagefile>WXPP005</imagefile></figure>
</para>
<para>
Click the <guimenu>DNS</guimenu> tab to add DNS server settings.
The example system uses manually configured DNS settings. When finished making changes, click the <guibutton>OK</guibutton> to commit
the settings. See <link linkend="WXPP014"/>.
- <image id="WXPP014"><imagedescription>DNS Configuration.</imagedescription><imagefile>WXPP014</imagefile></image>
+ <figure id="WXPP014"><title>DNS Configuration.</title><imagefile>WXPP014</imagefile></figure>
</para></step>
<step><para>
This step demonstrates an example system that uses manually configured WINS settings.
When finished making, changes click the <guibutton>OK</guibutton> to commit
the settings. See <link linkend="WXPP009"></link>.
- <image id="WXPP009"><imagedescription>WINS Configuration</imagedescription><imagefile>WXPP009</imagefile></image>
+ <figure id="WXPP009"><title>WINS Configuration</title><imagefile>WXPP009</imagefile></figure>
</para></step>
</procedure>
<step><para>
Right click on <guimenu>Local Area Connection</guimenu>, now click the
<guimenuitem>Properties</guimenuitem>. See <link linkend="w2kp001"></link>.
- <image id="w2kp001"><imagedescription>Local Area Connection Properties.</imagedescription><imagefile>w2kp001</imagefile></image>
+ <figure id="w2kp001"><title>Local Area Connection Properties.</title><imagefile>w2kp001</imagefile></figure>
</para></step>
<step><para>
<step><para>
The default setting is DHCP enabled operation.
(i.e., <quote>Obtain an IP address automatically</quote>). See <link linkend="w2kp002"/>.
- <image id="w2kp002"><imagedescription>Internet Protocol (TCP/IP) Properties.</imagedescription><imagefile>w2kp002</imagefile></image>
+ <figure id="w2kp002"><title>Internet Protocol (TCP/IP) Properties.</title><imagefile>w2kp002</imagefile></figure>
</para>
<para>
<step><para>
Click the <guimenu>Advanced</guimenu> button to proceed with TCP/IP configuration.
Refer to <link linkend="w2kp003"></link>.
- <image id="w2kp003"><imagedescription>Advanced Network Settings.</imagedescription><imagefile>w2kp003</imagefile></image>
+ <figure id="w2kp003"><title>Advanced Network Settings.</title><imagefile>w2kp003</imagefile></figure>
</para>
<para>
Click the <guimenu>DNS</guimenu> tab to add DNS server settings.
The example system uses manually configured DNS settings. When finished making changes,
click on <guibutton>OK</guibutton> to commit the settings. See <link linkend="w2kp004"></link>.
- <image id="w2kp004"><imagedescription>DNS Configuration.</imagedescription><imagefile>w2kp004</imagefile></image>
+ <figure id="w2kp004"><title>DNS Configuration.</title><imagefile>w2kp004</imagefile></figure>
</para></step>
<step><para>
This step demonstrates an example system that uses manually configured WINS settings.
When finished making changes, click on <guibutton>OK</guibutton> to commit the settings.
See <link linkend="w2kp005"></link>.
- <image id="w2kp005"><imagedescription>WINS Configuration.</imagedescription><imagefile>w2kp005</imagefile></image>
+ <figure id="w2kp005"><title>WINS Configuration.</title><imagefile>w2kp005</imagefile></figure>
</para></step>
</procedure>
<step><para>
In the box labeled <guimenuitem>The following network components are installed:</guimenuitem>,
click on <guimenu>Internet Protocol TCP/IP</guimenu>, now click on the <guibutton>Properties</guibutton> button. See <link linkend="WME001"></link>.
- <image id="WME001"><imagedescription>The Windows Me Network Configuration Panel.</imagedescription><imagefile>WME001</imagefile></image>
+ <figure id="WME001"><title>The Windows Me Network Configuration Panel.</title><imagefile>WME001</imagefile></figure>
</para></step>
<step><para>
for Microsoft Windows client support see, <link linkend="DHCP"></link>.
The default setting on Microsoft Windows Me workstations is for DHCP enabled operation,
i.e., <guimenu>Obtain IP address automatically</guimenu> is enabled. See <link linkend="WME002"></link>.
- <image id="WME002"><imagedescription>IP Address.</imagedescription><imagefile>WME002</imagefile></image>
+ <figure id="WME002"><title>IP Address.</title><imagefile>WME002</imagefile></figure>
</para>
<para>
<step><para>
The following example uses manually configured WINS settings. See <link linkend="WME005"></link>.
When finished making changes, click on <guibutton>OK</guibutton> to commit the settings.
- <image id="WME005"><imagedescription>DNS Configuration.</imagedescription><imagefile>WME005</imagefile></image>
+ <figure id="WME005"><title>DNS Configuration.</title><imagefile>WME005</imagefile></figure>
</para>
<para>
This is an example of a system that uses manually configured WINS settings. One situation where
this might apply is on a network that has a single DHCP server that provides settings for multiple
Windows workgroups or domains. See <link linkend="WME003"></link>.
- <image id="WME003"><imagedescription>WINS Configuration.</imagedescription><imagefile>WME003</imagefile></image>
+ <figure id="WME003"><title>WINS Configuration.</title><imagefile>WME003</imagefile></figure>
</para></step>
</procedure>
<step><para>
The opening panel is the same one that can be reached by clicking <guimenu>System</guimenu> on the Control Panel.
See <link linkend="wxpp001"></link>.
- <image id="wxpp001"><imagedescription>The General Panel.</imagedescription><imagefile>wxpp001</imagefile></image>
+ <figure id="wxpp001"><title>The General Panel.</title><imagefile>wxpp001</imagefile></figure>
</para></step>
<step><para>
Clicking the <guimenu>Network ID</guimenu> button will launch the configuration wizard. Do not use this with
Samba-3. If you wish to change the computer name, join or leave the domain, click the <guimenu>Change</guimenu> button.
See <link linkend="wxpp004"></link>.
- <image id="wxpp004"><imagedescription>The Computer Name Panel.</imagedescription><imagefile>wxpp004</imagefile></image>
+ <figure id="wxpp004"><title>The Computer Name Panel.</title><imagefile>wxpp004</imagefile></figure>
</para></step>
<step><para>
Click on <guimenu>Change</guimenu>. This panel shows that our example machine (TEMPTATION) is in a workgroup called WORKGROUP.
We will join the domain called MIDEARTH. See <link linkend="wxpp006"></link>.
- <image id="wxpp006"><imagedescription>The Computer Name Changes Panel.</imagedescription><imagefile>wxpp006</imagefile></image>
+ <figure id="wxpp006"><title>The Computer Name Changes Panel.</title><imagefile>wxpp006</imagefile></figure>
</para></step>
<step><para>
<para>
This panel shows that our example machine (TEMPTATION) is set to join the domain called MIDEARTH. See <link linkend="wxpp007"></link>.
- <image id="wxpp007"><imagedescription>The Computer Name Changes Panel &smbmdash; Domain MIDEARTH.</imagedescription><imagefile>wxpp007</imagefile></image>
+ <figure id="wxpp007"><title>The Computer Name Changes Panel &smbmdash; Domain MIDEARTH.</title><imagefile>wxpp007</imagefile></figure>
</para></step>
<step><para>
<para>
Enter the name <quote>root</quote> and the root password from your Samba-3 server. See <link linkend="wxpp008"></link>.
- <image id="wxpp008"><imagedescription>Computer Name Changes &smbmdash; User name and Password Panel.</imagedescription><imagefile>wxpp008</imagefile></image>
+ <figure id="wxpp008"><title>Computer Name Changes &smbmdash; User name and Password Panel.</title><imagefile>wxpp008</imagefile></figure>
</para></step>
<step><para>
<step><para>
The Network Configuration Panel allows all common network settings to be changed.
See <link linkend="WME009"></link>.
- <image id="WME009"><imagedescription>The Network Panel.</imagedescription><imagefile>WME009</imagefile></image>
+ <figure id="WME009"><title>The Network Panel.</title><imagefile>WME009</imagefile></figure>
</para>
<para>
<step><para>
The Client for Microsoft Networks Properties panel is the correct location to configure network logon
settings. See <link linkend="WME010"></link>.
- <image id="WME010"><imagedescription>Client for Microsoft Networks Properties Panel.</imagedescription><imagefile>WME010</imagefile></image>
+ <figure id="WME010"><title>Client for Microsoft Networks Properties Panel.</title><imagefile>WME010</imagefile></figure>
</para>
<para>
<step><para>
Click on the <guimenu>Identification</guimenu> button. This is the location at which the workgroup
(domain) name and the machine name (computer name) need to be set. See <link linkend="WME013"></link>.
- <image id="WME013"><imagedescription>Identification Panel.</imagedescription><imagefile>WME013</imagefile></image>
+ <figure id="WME013"><title>Identification Panel.</title><imagefile>WME013</imagefile></figure>
</para></step>
<step><para>
Now click the <guimenu>Access Control</guimenu> button. If you want to be able to assign share access
permissions using domain user and group accounts, it is necessary to enable
<guimenu>User-level access control</guimenu> as shown in this panel. See <link linkend="WME014"></link>.
- <image id="WME014"><imagedescription>Identification Panel.</imagedescription><imagefile>WME014</imagefile></image>
+ <figure id="WME014"><title>Identification Panel.</title><imagefile>WME014</imagefile></figure>
</para></step>
</procedure>
<xi:include href="../manpages-3/winbindd.8.xml"/>
</reference>
-
-
Published under the GNU GPL
(C) Jelmer Vernooij 2002-2004
- (C) Alexander Bokovoy 2002-2004
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"
<xsl:apply-templates/>
</xsl:template>
- <xsl:template match="smbfile">
- <xsl:apply-templates/>
- </xsl:template>
-
- <xsl:template match="image">
- <xsl:element name="figure">
- <xsl:attribute name="id">
- <xsl:choose>
- <xsl:when test="@id != ''">
- <xsl:value-of select="@id"/>
- </xsl:when>
- <xsl:otherwise>
- <xsl:value-of select="imagefile"/>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:attribute>
-
- <xsl:element name="title">
- <xsl:if test="imagedescription = ''">
- <xsl:message><xsl:text>imagedescription of image with id </xsl:text><xsl:value-of select="@id"/><xsl:text> is empty.</xsl:text></xsl:message>
- </xsl:if>
- <xsl:value-of select="imagedescription"/>
- </xsl:element>
- <xsl:element name="mediaobject">
- <xsl:element name="imageobject">
- <xsl:attribute name="role"><xsl:text>latex</xsl:text></xsl:attribute>
- <xsl:element name="imagedata">
- <xsl:attribute name="fileref">
- <xsl:value-of select="$latex.imagebasedir"/><xsl:text>images/</xsl:text><xsl:value-of select="imagefile"/></xsl:attribute>
- <xsl:attribute name="scale">
- <xsl:choose>
- <xsl:when test="@scale != ''">
- <xsl:value-of select="@scale"/>
- </xsl:when>
-
- <xsl:when test="imagefile/@scale != ''">
- <xsl:value-of select="imagefile/@scale"/>
- </xsl:when>
-
- <xsl:otherwise>
- <xsl:text>50</xsl:text>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:attribute>
- <xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
- </xsl:element>
+ <xsl:template match="imagefile">
+ <xsl:element name="mediaobject">
+ <xsl:element name="imageobject">
+ <xsl:attribute name="role"><xsl:text>latex</xsl:text></xsl:attribute>
+ <xsl:element name="imagedata">
+ <xsl:attribute name="fileref">
+ <xsl:value-of select="$latex.imagebasedir"/><xsl:text>images/</xsl:text><xsl:value-of select="text()"/></xsl:attribute>
+ <xsl:attribute name="scale">
+ <xsl:choose>
+ <xsl:when test="@scale != ''">
+ <xsl:value-of select="@scale"/>
+ </xsl:when>
+
+ <xsl:otherwise>
+ <xsl:text>50</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ <xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
</xsl:element>
- <xsl:element name="imageobject">
- <xsl:attribute name="role"><xsl:text>html</xsl:text></xsl:attribute>
- <xsl:element name="imagedata">
- <xsl:attribute name="fileref">
- <xsl:text>images/</xsl:text><xsl:value-of select="imagefile"/><xsl:text>.png</xsl:text></xsl:attribute>
- <xsl:attribute name="scale">
- <xsl:choose>
- <xsl:when test="@scale != ''">
- <xsl:value-of select="@scale"/>
- </xsl:when>
-
- <xsl:when test="imagefile/@scale != ''">
- <xsl:value-of select="imagefile/@scale"/>
- </xsl:when>
-
- <xsl:otherwise>
- <xsl:text>100</xsl:text>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:attribute>
- <xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
- </xsl:element>
+ </xsl:element>
+ <xsl:element name="imageobject">
+ <xsl:attribute name="role"><xsl:text>html</xsl:text></xsl:attribute>
+ <xsl:element name="imagedata">
+ <xsl:attribute name="fileref">
+ <xsl:text>images/</xsl:text><xsl:value-of select="imagefile"/><xsl:text>.png</xsl:text></xsl:attribute>
+ <xsl:attribute name="scale">
+ <xsl:choose>
+ <xsl:when test="@scale != ''">
+ <xsl:value-of select="@scale"/>
+ </xsl:when>
+
+ <xsl:otherwise>
+ <xsl:text>100</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ <xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
</xsl:element>
- <xsl:element name="imageobject">
- <xsl:element name="imagedata">
- <xsl:attribute name="fileref">
- <xsl:text>images/</xsl:text><xsl:value-of select="imagefile"/><xsl:text>.png</xsl:text></xsl:attribute>
- <xsl:attribute name="scale">
- <xsl:choose>
- <xsl:when test="@scale != ''">
- <xsl:value-of select="@scale"/>
- </xsl:when>
-
- <xsl:when test="imagefile/@scale != ''">
- <xsl:value-of select="imagefile/@scale"/>
- </xsl:when>
-
- <xsl:otherwise>
- <xsl:text>50</xsl:text>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:attribute>
- <xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
- </xsl:element>
+ </xsl:element>
+ <xsl:element name="imageobject">
+ <xsl:element name="imagedata">
+ <xsl:attribute name="fileref">
+ <xsl:text>images/</xsl:text><xsl:value-of select="imagefile"/><xsl:text>.png</xsl:text></xsl:attribute>
+ <xsl:attribute name="scale">
+ <xsl:choose>
+ <xsl:when test="@scale != ''">
+ <xsl:value-of select="@scale"/>
+ </xsl:when>
+
+ <xsl:otherwise>
+ <xsl:text>50</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ <xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
</xsl:element>
-
</xsl:element>
</xsl:element>
</xsl:template>
-
</xsl:stylesheet>
+++ /dev/null
-<?xml version='1.0'?>
-<!-- vim:set sts=2 shiftwidth=2 syntax=xml: -->
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- xmlns:exsl="http://exslt.org/common"
- xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"
- version="1.1"
- extension-element-prefixes="exsl">
-
-<xsl:output method="xml"/>
-
-<!-- Parse all varlistentries and extract those of them which are descriptions of smb.conf
- parameters. We determine them by existence of <anchor> element inside <term> element.
- If <anchor> is there, then its 'id' attribute is translated to lower case and is used
- as basis for file name for that parameter.
--->
-<xsl:template match="smbfile">
- <!-- reconstruct varlistentry - not all of them will go into separate files
- and also we must repair the main varlistentry itself.
- -->
- <xsl:variable name="content">
- <xsl:apply-templates/>
- </xsl:variable>
- <!-- Now put varlistentry into separate file _if_ it has anchor associated with it -->
- <xsl:variable name="filename"><xsl:text>output/examples/</xsl:text><xsl:value-of select="@name"/></xsl:variable>
- <!-- Debug message for an operator, just to show progress of processing :) -->
- <xsl:message>
- <xsl:text>Writing </xsl:text>
- <xsl:value-of select="$filename"/>
- </xsl:message>
- <!-- Write finally varlistentry to a separate file -->
- <exsl:document href="{$filename}"
- method="xml"
- encoding="UTF-8"
- indent="yes"
- omit-xml-declaration="yes">
- <xsl:copy-of select="$content"/>
- </exsl:document>
-</xsl:template>
-
-</xsl:stylesheet>
-
<xsl:strip-space elements="smbconfoption smbconfsection"/>
- <xsl:template match="smbfile">
- <xsl:apply-templates/>
- </xsl:template>
-
<xsl:template match="smbconfexample/smbconfsection|smbconfblock/smbconfsection">
<xsl:text> </xsl:text>
<xsl:value-of select="."/><xsl:text> </xsl:text>