[Pkg-cyrus-sasl2-commits] r245 - in /cyrus-sasl-2.1/trunk/debian: control rules sasl-sample-client.sgml sasl-sample-server.sgml

fabbe at users.alioth.debian.org fabbe at users.alioth.debian.org
Tue Jul 10 14:35:18 UTC 2007


Author: fabbe
Date: Tue Jul 10 14:35:18 2007
New Revision: 245

URL: http://svn.debian.org/wsvn/pkg-cyrus-sasl2/?sc=1&rev=245
Log:
Man pages for sasl-sample-client and -server.

Added:
    cyrus-sasl-2.1/trunk/debian/sasl-sample-client.sgml
    cyrus-sasl-2.1/trunk/debian/sasl-sample-server.sgml
Modified:
    cyrus-sasl-2.1/trunk/debian/control
    cyrus-sasl-2.1/trunk/debian/rules

Modified: cyrus-sasl-2.1/trunk/debian/control
URL: http://svn.debian.org/wsvn/pkg-cyrus-sasl2/cyrus-sasl-2.1/trunk/debian/control?rev=245&op=diff
==============================================================================
--- cyrus-sasl-2.1/trunk/debian/control (original)
+++ cyrus-sasl-2.1/trunk/debian/control Tue Jul 10 14:35:18 2007
@@ -4,7 +4,7 @@
 Maintainer: Debian Cyrus SASL Team <pkg-cyrus-sasl2-debian-devel at lists.alioth.debian.org>
 Uploaders: Fabian Fagerholm <fabbe at debian.org>, Roberto C. Sanchez <roberto at connexer.com>
 Standards-Version: 3.7.2
-Build-Depends: debhelper (>= 5.0.0), dpatch, autotools-dev, automake1.9, autoconf, libtool, libdb4.2-dev (>= 4.2.52-24), libpam0g-dev (>= 0.76-22), libssl-dev (>= 0.9.7e-3), libmysqlclient15-dev (>= 5.0.20-1), libopie-dev (>= 2.32-10), libpq-dev (>= 8.1.3-4), libkrb5-dev, libsqlite0-dev (>= 2.8.16-1), libldap2-dev (>= 2.1.30-8), chrpath, groff-base, debconf (>= 0.5) | debconf-2.0, po-debconf
+Build-Depends: debhelper (>= 5.0.0), dpatch, autotools-dev, automake1.9, autoconf, libtool, libdb4.2-dev (>= 4.2.52-24), libpam0g-dev (>= 0.76-22), libssl-dev (>= 0.9.7e-3), libmysqlclient15-dev (>= 5.0.20-1), libopie-dev (>= 2.32-10), libpq-dev (>= 8.1.3-4), libkrb5-dev, libsqlite0-dev (>= 2.8.16-1), libldap2-dev (>= 2.1.30-8), chrpath, groff-base, debconf (>= 0.5) | debconf-2.0, po-debconf, docbook-to-man
 Build-Conflicts: heimdal-dev
 
 Package: sasl2-bin

Modified: cyrus-sasl-2.1/trunk/debian/rules
URL: http://svn.debian.org/wsvn/pkg-cyrus-sasl2/cyrus-sasl-2.1/trunk/debian/rules?rev=245&op=diff
==============================================================================
--- cyrus-sasl-2.1/trunk/debian/rules (original)
+++ cyrus-sasl-2.1/trunk/debian/rules Tue Jul 10 14:35:18 2007
@@ -192,6 +192,12 @@
 ###
 build-indep: build-indep-stamp
 build-indep-stamp:
+	# Build the sasl-sample-client and sasl-sample-server man pages.
+	/usr/bin/docbook-to-man debian/sasl-sample-client.sgml \
+		> sasl-sample-client.8
+	/usr/bin/docbook-to-man debian/sasl-sample-server.sgml \
+		> sasl-sample-server.8
+
 	touch build-indep-stamp
 
 ###
@@ -227,6 +233,9 @@
 	chrpath -d $(TMPPKG)/usr/sbin/sasldblistusers2 \
 		$(TMPPKG)/usr/sbin/saslpasswd2
 	chrpath -d $(TMPPKG)/usr/lib/sasl2/libsql.so.2.0.22
+
+	# Install the sasl-sample-client and -server man pages.
+	dh_installman -psasl2-bin sasl-sample-client.8 sasl-sample-server.8
 
 ###
 # Build architecture-dependent files.

Added: cyrus-sasl-2.1/trunk/debian/sasl-sample-client.sgml
URL: http://svn.debian.org/wsvn/pkg-cyrus-sasl2/cyrus-sasl-2.1/trunk/debian/sasl-sample-client.sgml?rev=245&op=file
==============================================================================
--- cyrus-sasl-2.1/trunk/debian/sasl-sample-client.sgml (added)
+++ cyrus-sasl-2.1/trunk/debian/sasl-sample-client.sgml Tue Jul 10 14:35:18 2007
@@ -1,0 +1,264 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'. The docbook-to-man binary is found in the docbook-to-man
+	 package. -->
+
+	<!ENTITY dhfirstname	"<firstname>Fabian</firstname>">
+	<!ENTITY dhsurname		"<surname>Fagerholm</surname>">
+
+	<!-- Please adjust the date whenever revising the manpage. -->
+	<!ENTITY dhdate		"<date>Jul 10, 2007</date>">
+
+	<!ENTITY dhsection		"<manvolnum>8</manvolnum>">
+	<!ENTITY dhemail		"<email>fabbe at debian.org</email>">
+	<!ENTITY dhusername	"Fabian Fagerholm">
+	<!ENTITY dhucpackage	"<refentrytitle>SASL-SAMPLE-CLIENT</refentrytitle>">
+	<!ENTITY dhpackage		"sasl-sample-client">
+	<!ENTITY debian		"<productname>Debian</productname>">
+	<!ENTITY gnu			"<acronym>GNU</acronym>">
+
+]>
+
+<refentry>
+	<refentryinfo>
+		<address>&dhemail;</address>
+		<author>&dhfirstname; &dhsurname;</author>
+		<copyright>
+			<year>2007</year>
+			<holder>&dhusername;</holder>
+		</copyright>
+		&dhdate;
+	</refentryinfo>
+	<refmeta>
+		&dhucpackage;
+
+		&dhsection;
+	</refmeta>
+	<refnamediv>
+		<refname>&dhpackage;</refname>
+		<refpurpose>Sample client program for demonstrating and testing SASL authentication.</refpurpose>
+	</refnamediv>
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>&dhpackage;</command>
+			<arg>-b min=<replaceable>N</replaceable>,max=<replaceable>N</replaceable></arg>
+			<arg>-e ssf=<replaceable>N</replaceable>,id=<replaceable>ID</replaceable></arg>
+			<arg>-m <replaceable>MECH</replaceable></arg>
+			<arg>-f <replaceable>FLAGS</replaceable></arg>
+			<arg>-i local=<replaceable>IP</replaceable>,remote=<replaceable>IP</replaceable></arg>
+			<arg>-p <replaceable>PATH</replaceable></arg>
+			<arg>-s <replaceable>NAME</replaceable></arg>
+			<arg>-n <replaceable>FQDN</replaceable></arg>
+			<arg>-u <replaceable>ID</replaceable></arg>
+			<arg>-a <replaceable>ID</replaceable></arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+	<refsect1>
+		<title>DESCRIPTION</title>
+
+		<para>This manual page documents briefly the
+		  <command>&dhpackage;</command> command.</para>
+
+		<para>This manual page was written for the &debian; distribution
+		  because the original program does not have a manual page.</para>
+
+		<para><command>&dhpackage;</command> is a program to demonstrate
+		  and test SASL authentication. It implements the client part, and
+		  the server part is available as sasl-sample-server.</para>
+	</refsect1>
+	<refsect1>
+		<title>OPTIONS</title>
+
+		<para>A summary of options is included below.</para>
+
+		<variablelist>
+
+			<varlistentry>
+				<term><option>-b</option></term>
+				<listitem>
+					<para>Number of bits to use for encryption.</para>
+					<variablelist>
+						<varlistentry>
+							<term>min=N</term>
+							<listitem>
+								<para>minimum number of bits to use (1 => integrity)</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>max=N</term>
+							<listitem>
+								<para>maximum number of bits to use</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+
+			<varlistentry>
+				<term><option>-e</option></term>
+				<listitem>
+					<para>Assume external encryption.</para>
+					<variablelist>
+						<varlistentry>
+							<term>ssf=N</term>
+							<listitem>
+								<para>external mech provides N bits of encryption</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>id=ID</term>
+							<listitem>
+								<para>external mech provides authentication id ID</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-m</option></term>
+				<listitem>
+					<para>Force use of MECH for security.</para>
+				</listitem>
+			</varlistentry>
+			
+			<varlistentry>
+				<term><option>-f</option></term>
+				<listitem>
+					<para>Set security flags.</para>
+					<variablelist>
+						<varlistentry>
+							<term>noplain</term>
+							<listitem>
+								<para>require security vs. passive attacks</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>noactive</term>
+							<listitem>
+								<para>require security vs. active attacks</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>nodict</term>
+							<listitem>
+								<para>require security vs. passive dictionary attacks</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>forwardsec</term>
+							<listitem>
+								<para>require forward secrecy</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>maximum</term>
+							<listitem>
+								<para>require all security flags</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>passcred</term>
+							<listitem>
+								<para>attempt to pass client credentials</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-i</option></term>
+				<listitem>
+					<para>Set IP addresses (required by some mechs).</para>
+					<variablelist>
+						<varlistentry>
+							<term>local=IP;PORT</term>
+							<listitem>
+								<para>set local address to IP, port PORT</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>remote=IP;PORT</term>
+							<listitem>
+								<para>set remote address to IP, port PORT</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-p</option></term>
+				<listitem>
+					<para>Colon-separated search path for mechanisms.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-r</option></term>
+				<listitem>
+					<para>Realm to use.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-s</option></term>
+				<listitem>
+					<para>Service name passed to mechanisms.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-n</option></term>
+				<listitem>
+					<para>Server fully-qualified domain name.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-u</option></term>
+				<listitem>
+					<para>User (authorization) id to request.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-a</option></term>
+				<listitem>
+					<para>Id to authenticate as.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-d</option></term>
+				<listitem>
+					<para>Disable client-send-first.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-l</option></term>
+				<listitem>
+					<para>Enable server-send-last.</para>
+				</listitem>
+			</varlistentry>
+
+		</variablelist>
+	</refsect1>
+	<refsect1>
+		<title>AUTHOR</title>
+
+		<para>This manual page was written by &dhusername; &dhemail; for
+		  the &debian; system (but may be used by others). Permission is
+		  granted to redistribute it and/or modify it under the terms of
+		  the &gnu; General Public License as published by the Free
+		  Software Foundation; either version 2 of the License, or (at
+		  your option) any later version.</para>
+	
+	</refsect1>
+</refentry>

Added: cyrus-sasl-2.1/trunk/debian/sasl-sample-server.sgml
URL: http://svn.debian.org/wsvn/pkg-cyrus-sasl2/cyrus-sasl-2.1/trunk/debian/sasl-sample-server.sgml?rev=245&op=file
==============================================================================
--- cyrus-sasl-2.1/trunk/debian/sasl-sample-server.sgml (added)
+++ cyrus-sasl-2.1/trunk/debian/sasl-sample-server.sgml Tue Jul 10 14:35:18 2007
@@ -1,0 +1,243 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'. The docbook-to-man binary is found in the docbook-to-man
+	 package. -->
+
+	<!ENTITY dhfirstname	"<firstname>Fabian</firstname>">
+	<!ENTITY dhsurname		"<surname>Fagerholm</surname>">
+
+	<!-- Please adjust the date whenever revising the manpage. -->
+	<!ENTITY dhdate		"<date>Jul 10, 2007</date>">
+
+	<!ENTITY dhsection		"<manvolnum>8</manvolnum>">
+	<!ENTITY dhemail		"<email>fabbe at debian.org</email>">
+	<!ENTITY dhusername	"Fabian Fagerholm">
+	<!ENTITY dhucpackage	"<refentrytitle>SASL-SAMPLE-SERVER</refentrytitle>">
+	<!ENTITY dhpackage		"sasl-sample-server">
+	<!ENTITY debian		"<productname>Debian</productname>">
+	<!ENTITY gnu			"<acronym>GNU</acronym>">
+
+]>
+
+<refentry>
+	<refentryinfo>
+		<address>&dhemail;</address>
+		<author>&dhfirstname; &dhsurname;</author>
+		<copyright>
+			<year>2007</year>
+			<holder>&dhusername;</holder>
+		</copyright>
+		&dhdate;
+	</refentryinfo>
+	<refmeta>
+		&dhucpackage;
+
+		&dhsection;
+	</refmeta>
+	<refnamediv>
+		<refname>&dhpackage;</refname>
+		<refpurpose>Sample server program for demonstrating and testing SASL authentication.</refpurpose>
+	</refnamediv>
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>&dhpackage;</command>
+			<arg>-b min=<replaceable>N</replaceable>,max=<replaceable>N</replaceable></arg>
+			<arg>-e ssf=<replaceable>N</replaceable>,id=<replaceable>ID</replaceable></arg>
+			<arg>-m <replaceable>MECH</replaceable></arg>
+			<arg>-f <replaceable>FLAGS</replaceable></arg>
+			<arg>-i local=<replaceable>IP</replaceable>,remote=<replaceable>IP</replaceable></arg>
+			<arg>-p <replaceable>PATH</replaceable></arg>
+			<arg>-d <replaceable>DOM</replaceable></arg>
+			<arg>-u <replaceable>DOM</replaceable></arg>
+			<arg>-s <replaceable>NAME</replaceable></arg>
+			<arg>-l</arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+	<refsect1>
+		<title>DESCRIPTION</title>
+
+		<para>This manual page documents briefly the
+		  <command>&dhpackage;</command> command.</para>
+
+		<para>This manual page was written for the &debian; distribution
+		  because the original program does not have a manual page.</para>
+
+		<para><command>&dhpackage;</command> is a program to demonstrate
+		  and test SASL authentication. It implements the server part, and
+		  the client part is available as sasl-sample-client.</para>
+	</refsect1>
+	<refsect1>
+		<title>OPTIONS</title>
+
+		<para>A summary of options is included below.</para>
+
+		<variablelist>
+
+			<varlistentry>
+				<term><option>-b</option></term>
+				<listitem>
+					<para>Number of bits to use for encryption.</para>
+					<variablelist>
+						<varlistentry>
+							<term>min=N</term>
+							<listitem>
+								<para>minimum number of bits to use (1 => integrity)</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>max=N</term>
+							<listitem>
+								<para>maximum number of bits to use</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+
+			<varlistentry>
+				<term><option>-e</option></term>
+				<listitem>
+					<para>Assume external encryption.</para>
+					<variablelist>
+						<varlistentry>
+							<term>ssf=N</term>
+							<listitem>
+								<para>external mech provides N bits of encryption</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>id=ID</term>
+							<listitem>
+								<para>external mech provides authentication id ID</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-m</option></term>
+				<listitem>
+					<para>Force use of MECH for security.</para>
+				</listitem>
+			</varlistentry>
+			
+			<varlistentry>
+				<term><option>-f</option></term>
+				<listitem>
+					<para>Set security flags.</para>
+					<variablelist>
+						<varlistentry>
+							<term>noplain</term>
+							<listitem>
+								<para>require security vs. passive attacks</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>noactive</term>
+							<listitem>
+								<para>require security vs. active attacks</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>nodict</term>
+							<listitem>
+								<para>require security vs. passive dictionary attacks</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>forwardsec</term>
+							<listitem>
+								<para>require forward secrecy</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>maximum</term>
+							<listitem>
+								<para>require all security flags</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>passcred</term>
+							<listitem>
+								<para>attempt to pass client credentials</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-i</option></term>
+				<listitem>
+					<para>Set IP addresses (required by some mechs).</para>
+					<variablelist>
+						<varlistentry>
+							<term>local=IP;PORT</term>
+							<listitem>
+								<para>set local address to IP, port PORT</para>
+							</listitem>
+						</varlistentry>
+						<varlistentry>
+							<term>remote=IP;PORT</term>
+							<listitem>
+								<para>set remote address to IP, port PORT</para>
+							</listitem>
+						</varlistentry>
+					</variablelist>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-p</option></term>
+				<listitem>
+					<para>Colon-separated search path for mechanisms.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-s</option></term>
+				<listitem>
+					<para>Service name passed to mechanisms.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-d</option></term>
+				<listitem>
+					<para>Local server domain.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-u</option></term>
+				<listitem>
+					<para>User domain.</para>
+				</listitem>
+			</varlistentry>
+
+			<varlistentry>
+				<term><option>-l</option></term>
+				<listitem>
+					<para>Enable server-send-last.</para>
+				</listitem>
+			</varlistentry>
+
+		</variablelist>
+	</refsect1>
+	<refsect1>
+		<title>AUTHOR</title>
+
+		<para>This manual page was written by &dhusername; &dhemail; for
+		  the &debian; system (but may be used by others). Permission is
+		  granted to redistribute it and/or modify it under the terms of
+		  the &gnu; General Public License as published by the Free
+		  Software Foundation; either version 2 of the License, or (at
+		  your option) any later version.</para>
+	
+	</refsect1>
+</refentry>




More information about the Pkg-cyrus-sasl2-commits mailing list