source: chapter06/mktemp.xml@ 1fe35e1

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<section xmlns="http://docbook.org/docbook-ng"
         xml:id="ch-system-mktemp" xreflabel="Mktemp" role="wrap">
<info><title>Mktemp-&mktemp-version;</title></info>
<?dbhtml filename="mktemp.html"?>

<indexterm zone="ch-system-mktemp"><primary sortas="a-Mktemp">Mktemp</primary></indexterm>

<section role="package"><info><title/></info>
<para>The Mktemp package contains programs used to create secure temporary
files in shell scripts.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>317 KB</seg></seglistitem>
</segmentedlist>

<para>The installation dependencies for Mktemp haven't been checked yet.</para>

</section>

<section role="installation">
<info><title>Installation of Mktemp</title></info>

<para>Many scripts still use the deprecated <command>tempfile</command>
program, which has functionality much the same as <command>mktemp</command>.
Patch Mktemp to include a <command>tempfile</command> wrapper:</para>

<screen><userinput>patch -Np1 -i ../mktemp-&mktemp-version;-add_tempfile-1.patch</userinput></screen>

<para>Now prepare Mktemp for compilation:</para>

<screen><userinput>./configure --prefix=/usr --with-libc</userinput></screen>

<para>The meaning of the configure option:</para>

<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.</para></listitem>
</varlistentry>
</variablelist>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>Now install it:</para>

<screen><userinput>make install
make install-tempfile</userinput></screen>

</section>


<section xml:id="contents-mktemp" role="content"><info><title>Contents of Mktemp</title></info>

<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>mktemp, tempfile</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry xml:id="mktemp">
<term><command>mktemp</command></term>
<listitem>
<indexterm zone="ch-system-mktemp mktemp"><primary sortas="b-mktemp">mktemp</primary></indexterm>
<para>creates temporary files in a secure manner. It is used in scripts.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="tempfile">
<term><command>tempfile</command></term>
<listitem>
<indexterm zone="ch-system-mktemp tempfile"><primary sortas="b-tempfile">tempfile</primary></indexterm>
<para>creates temporary files in a less secure manner than 
<command>mktemp</command>. It is installed for backwards-compatibility.</para>
</listitem>
</varlistentry>
</variablelist>

</section>

</section>