<para><command>make <maketarget>delete-old</maketarget></command></para>

	  <para>This target deletes old (obsolete) files.  This is important

	    because sometimes they cause problems if left on the disk, for

	    example the presence of the old <filename>utmp.h</filename> causes

	    problems in some ports when the new

	    <filename>utmpx.h</filename> is installed.</para>

	</listitem>

	<listitem>

	<listitem>

	  <para><command>make <maketarget>delete-old-libs</maketarget></command></para>

	  <para>Remove any obsolete libraries to avoid conflicts with newer

	    ones.  Make sure that all ports have been rebuilt to use the new

	    libraries before you delete the old ones.</para>

	</listitem>

&prompt.root; <userinput>make delete-old</userinput>

    <sect2 id="make-delete-old">

      <sect2info>

	<authorgroup>

	  <author>

	    <firstname>Anton</firstname>

	    <surname>Shterenlikht</surname>

	    <contrib>Based on notes provided by </contrib>

	  </author>

	</authorgroup>

      </sect2info>

      <title>Deleting obsolete files and directories</title>

      <indexterm>

	<primary>Deleting obsolete files and directories</primary>

      </indexterm>

      <para>As a part of the &os; development lifecycle, it happens from time

	to time that files and their contents become obsolete.  This may be

	because their functionality is implemented elsewhere, the version number

	of the library has changed or it was removed from the system entirely.

	This includes old files, libraries and directories, which should

	be removed when updating the system.  The benefit for the user is that

	the system is not cluttered with old files which take up unnecessary

	space on the storage (and backup) medium.  Additionally, if the old

	library had a security or stability issue, you should update to the

	newer library to keep your system safe and prevent crashes caused by

	the old library implementation.  The files, directories, and libraries

	that are considered obsolete are listed in

	<filename>/usr/src/ObsoleteFiles.inc</filename>.  The following

	instructions will help you removing these obsolete files during the

	system upgrade process.</para>

      <para>After the <command>make

	<maketarget>installworld</maketarget></command> and the subsequent

	<command>mergemaster</command> commands have finished successfully, you

	should check for obsolete files and libraries as follows:</para>

      <screen>&prompt.root; <userinput>cd /usr/src</userinput>

&prompt.root; <userinput>make check-old</userinput></screen>

      <para>If any obsolete files are found, they can be deleted using the

	following commands:</para>

      <screen>&prompt.root; <userinput>make delete-old</userinput></screen>

      <tip>

	<para>See <filename>/usr/src/Makefile</filename>

	  for more targets of interest.</para>

      </tip>

      <para>A prompt is displayed before deleting each obsolete file.  You can

	skip the prompt and let the system remove these files automatically by

	using the <makevar>BATCH_DELETE_OLD_FILES</makevar> make-variable as

	follows:</para>

      <screen>&prompt.root; <userinput>make -DBATCH_DELETE_OLD_FILES delete-old</userinput></screen>

      <para>You can also achieve the same goal by piping these commands through

	<command>yes</command> like this:</para>

      <screen>&prompt.root; <userinput>yes|make delete-old</userinput></screen>

    </sect2>

    <sect2 id="updating-upgrading-make-delete-old-libs">

      <title>Deleting obsolete libraries</title>

      <warning>

	<title>Warning</title>

	<para>Deleting obsolete files will break applications that still

	  depend on those obsolete files.  This is especially true for old

	  libraries. In most cases, you need to recompile the programs, ports,

	  or libraries that used the old library before <command>make

	<maketarget>delete-old-libs</maketarget></command> is executed.</para>

      </warning>

      <para>Utilities for checking shared library dependencies are available

	from the Ports Collection in <filename

	role="package">sysutils/libchk</filename> or <filename

	role="package">sysutils/bsdadminscripts</filename>.</para>

      <para>Obsolete shared libraries can conflict with newer libraries,

	causing messages like these:</para>

      <screen>/usr/bin/ld: warning: libz.so.4, needed by /usr/local/lib/libtiff.so, may conflict with libz.so.5

/usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may conflict with librpcsvc.so.5</screen>

      <para>To solve these problems, determine which port installed the

	library:</para>

      <screen>&prompt.root; <userinput>pkg_info -W  /usr/local/lib/libtiff.so</userinput>

  /usr/local/lib/libtiff.so was installed by package tiff-3.9.4

  &prompt.root; <userinput>pkg_info -W /usr/local/lib/libXext.so</userinput>

  /usr/local/lib/libXext.so was installed by package libXext-1.1.1,1</screen>

      <para>Then deinstall, rebuild and reinstall the port. The <filename

	role="package">ports-mgmt/portmaster</filename> and <filename

	role="package">ports-mgmt/portupgrade</filename> utilities can be used

	to automate this process.  After you've made sure that all ports are

	rebuilt and do not use the old libraries anymore, you can delete them

	using the

	following command:</para>

      <screen>&prompt.root; <userinput>make delete-old-libs</userinput></screen>

    </sect2>