diff options
Diffstat (limited to 'chapter06/mktemp.xml')
| -rw-r--r-- | chapter06/mktemp.xml | 168 |
1 files changed, 98 insertions, 70 deletions
diff --git a/chapter06/mktemp.xml b/chapter06/mktemp.xml index 2fd6bfca3..670c24e47 100644 --- a/chapter06/mktemp.xml +++ b/chapter06/mktemp.xml @@ -1,100 +1,128 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-system-mktemp" role="wrap"> -<title>Mktemp-&mktemp-version;</title> -<?dbhtml filename="mktemp.html"?> + <?dbhtml filename="mktemp.html"?> -<indexterm zone="ch-system-mktemp"><primary sortas="a-Mktemp">Mktemp</primary></indexterm> + <title>Mktemp-&mktemp-version;</title> -<sect2 role="package"><title/> -<para>The Mktemp package contains programs used to create secure temporary -files in shell scripts.</para> + <indexterm zone="ch-system-mktemp"> + <primary sortas="a-Mktemp">Mktemp</primary> + </indexterm> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>436 KB</seg></seglistitem> -</segmentedlist> + <sect2 role="package"> + <title/> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Coreutils, Make, and Patch</seg></seglistitem> -</segmentedlist> -</sect2> + <para>The Mktemp package contains programs used to create secure temporary + files in shell scripts.</para> -<sect2 role="installation"> -<title>Installation of Mktemp</title> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<para>Many scripts still use the deprecated -<command>tempfile</command> program, which has functionality similar -to <command>mktemp</command>. Patch Mktemp to include a -<command>tempfile</command> wrapper:</para> + <seglistitem> + <seg>0.1 SBU</seg> + <seg>436 KB</seg> + </seglistitem> + </segmentedlist> -<screen><userinput>patch -Np1 -i ../&mktemp-tempfile-patch;</userinput></screen> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<para>Prepare Mktemp for compilation:</para> + <seglistitem> + <seg>Coreutils, Make, and Patch</seg> + </seglistitem> + </segmentedlist> -<screen><userinput>./configure --prefix=/usr --with-libc</userinput></screen> + </sect2> -<para>The meaning of the configure options:</para> + <sect2 role="installation"> + <title>Installation of Mktemp</title> -<variablelist> -<varlistentry> -<term><parameter>--with-libc</parameter></term> -<listitem><para>This causes the <command>mktemp</command> program to -use the <emphasis>mkstemp</emphasis> and <emphasis>mkdtemp</emphasis> -functions from the system C library instead of its own implementation of them. -</para></listitem> -</varlistentry> -</variablelist> + <para>Many scripts still use the deprecated + <command>tempfile</command> program, which has functionality similar + to <command>mktemp</command>. Patch Mktemp to include a + <command>tempfile</command> wrapper:</para> -<para>Compile the package:</para> +<screen><userinput>patch -Np1 -i ../&mktemp-tempfile-patch;</userinput></screen> -<screen><userinput>make</userinput></screen> + <para>Prepare Mktemp for compilation:</para> -<para>This package does not come with a test suite.</para> +<screen><userinput>./configure --prefix=/usr --with-libc</userinput></screen> -<para>Install the package:</para> + <variablelist> + <title>The meaning of the configure options:</title> -<screen><userinput>make install -make install-tempfile</userinput></screen> - -</sect2> + <varlistentry> + <term><parameter>--with-libc</parameter></term> + <listitem> + <para>This causes the <command>mktemp</command> program to use the + <emphasis>mkstemp</emphasis> and <emphasis>mkdtemp</emphasis> + functions from the system C library instead of its own implementation + of them. </para> + </listitem> + </varlistentry> + </variablelist> -<sect2 id="contents-mktemp" role="content"><title>Contents of Mktemp</title> + <para>Compile the package:</para> -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>mktemp and tempfile</seg></seglistitem> -</segmentedlist> +<screen><userinput>make</userinput></screen> -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> + <para>This package does not come with a test suite.</para> -<varlistentry id="mktemp"> -<term><command>mktemp</command></term> -<listitem> -<para>Creates temporary files in a secure manner; it is used in scripts</para> -<indexterm zone="ch-system-mktemp mktemp"><primary sortas="b-mktemp">mktemp</primary></indexterm> -</listitem> -</varlistentry> + <para>Install the package:</para> -<varlistentry id="tempfile"> -<term><command>tempfile</command></term> -<listitem> -<para>Creates temporary files in a less secure manner than -<command>mktemp</command>; it is installed for backwards-compatibility</para> -<indexterm zone="ch-system-mktemp tempfile"><primary sortas="b-tempfile">tempfile</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> +<screen><userinput>make install +make install-tempfile</userinput></screen> -</sect2> + </sect2> + + <sect2 id="contents-mktemp" role="content"> + <title>Contents of Mktemp</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>mktemp and tempfile</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="mktemp"> + <term><command>mktemp</command></term> + <listitem> + <para>Creates temporary files in a secure manner; it is used in + scripts</para> + <indexterm zone="ch-system-mktemp mktemp"> + <primary sortas="b-mktemp">mktemp</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="tempfile"> + <term><command>tempfile</command></term> + <listitem> + <para>Creates temporary files in a less secure manner than + <command>mktemp</command>; it is installed for + backwards-compatibility</para> + <indexterm zone="ch-system-mktemp tempfile"> + <primary sortas="b-tempfile">tempfile</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - |