Update and expand a bit the instructions for building a statically

linked copy of named-xfer.  Also add details on cleaning the source
tree after the build to avoid leaving stale objects/binaries around.

Prompted by:	jeev@boldinternet.net
This commit is contained in:
Giorgos Keramidas 2003-05-13 20:20:04 +00:00
parent 8ada16df74
commit fd5ca98a29
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=16895

View file

@ -5000,16 +5000,36 @@ $TTL 6h
<para>Build a statically linked copy of
<application>named-xfer</application>, and copy it into the sandbox:</para>
<screen>&prompt.root; <userinput>cd /usr/src/lib/libisc && make clean all</userinput>
&prompt.root; <userinput>cd /usr/src/lib/libbind && make clean all</userinput>
&prompt.root; <userinput>cd /usr/src/libexec/named-xfer && make NOSHARED=yes all</userinput>
<screen>&prompt.root; <userinput>cd /usr/src/lib/libisc</userinput>
&prompt.root; <userinput>make cleandir && make cleandir && make depend && make all</userinput>
&prompt.root; <userinput>cd /usr/src/lib/libbind</userinput>
&prompt.root; <userinput>make cleandir && make cleandir && make depend && make all</userinput>
&prompt.root; <userinput>cd /usr/src/libexec/named-xfer</userinput>
&prompt.root; <userinput>make cleandir && make cleandir && make depend && make NOSHARED=yes all</userinput>
&prompt.root; <userinput>cp named-xfer /etc/namedb/bin && chmod 555 /etc/namedb/bin/named-xfer</userinput><co id="clean-cruft"></screen>
<para>After your statically linked
<command>named-xfer</command> is installed some cleaning up
is required, to avoid leaving stale copies of libraries or
programs in your source tree:</para>
<screen>&prompt.root; <userinput>cd /usr/src/lib/libisc</userinput>
&prompt.root; <userinput>make cleandir</userinput>
&prompt.root; <userinput>cd /usr/src/lib/libbind</userinput>
&prompt.root; <userinput>make cleandir</userinput>
&prompt.root; <userinput>cd /usr/src/libexec/named-xfer</userinput>
&prompt.root; <userinput>make cleandir</userinput></screen>
<calloutlist>
<callout arearefs="clean-cruft">
<para>This step has been reported to fail occasionally. If this
happens to you, then issue the command:</para>
<screen>&prompt.root; <userinput>cd /usr/src && make cleandir && make cleandir</userinput></screen>
<screen>&prompt.root; <userinput>cd /usr/src && make cleandir && make cleandir</userinput></screen>
<para>and delete your <filename>/usr/obj</filename> tree:</para>
<screen>&prompt.root; <userinput>rm -fr /usr/obj && mkdir /usr/obj</userinput></screen>
<para>This will clean out any <quote>cruft</quote> from your
source tree, and retrying the steps above should then work.</para>