From owner-svn-doc-head@FreeBSD.ORG Wed May 29 17:46:30 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 709B9F05; Wed, 29 May 2013 17:46:30 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 4F0E2C1C; Wed, 29 May 2013 17:46:30 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r4THkUx1080701; Wed, 29 May 2013 17:46:30 GMT (envelope-from crees@svn.freebsd.org) Received: (from crees@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r4THkUMT080700; Wed, 29 May 2013 17:46:30 GMT (envelope-from crees@svn.freebsd.org) Message-Id: <201305291746.r4THkUMT080700@svn.freebsd.org> From: Chris Rees Date: Wed, 29 May 2013 17:46:30 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41772 - head/en_US.ISO8859-1/books/handbook/cutting-edge X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 29 May 2013 17:46:30 -0000 Author: crees Date: Wed May 29 17:46:29 2013 New Revision: 41772 URL: http://svnweb.freebsd.org/changeset/doc/41772 Log: Removing old files is not an optional step on updating and upgrading FreeBSD. Reflect this by merging make delete-old section into the updating section. This is a movement-only change; the content change will follow PR: docs/162699 Approved by: gjb (mentor) Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Wed May 29 15:05:43 2013 (r41771) +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Wed May 29 17:46:29 2013 (r41772) @@ -2630,6 +2630,72 @@ Script done, … + + + + + Anton + Shterenlikht + Based on notes provided by + + + + Deleting Obsolete Files, Directories and Libraries + + + Deleting obsolete files, directories and + libraries + + + As a part of the &os; development lifecycle, files and their + contents occasionally become obsolete. This may be because + 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 + is that the system is not cluttered with old files which take up + unnecessary space on the storage and backup media. + Additionally, if the old library has a security or stability + issue, the system should be updated to the newer library to keep + it safe and to prevent crashes caused by the old library. + Files, directories, and libraries which are considered obsolete + are listed in /usr/src/ObsoleteFiles.inc. + The following instructions should be used to remove obsolete + files during the system upgrade process. + + Follow the steps outlined in . After the + make installworld + and the subsequent mergemaster have finished + successfully, check for obsolete files and libraries as + follows: + + &prompt.root; cd /usr/src + &prompt.root; make check-old + + If any obsolete files are found, they can be deleted using + the following command: + + &prompt.root; make delete-old + + + Refer to /usr/src/Makefile + for more targets of interest. + + + A prompt is displayed before deleting each obsolete file. + To skip the prompt and let the system remove these files + automatically, use + BATCH_DELETE_OLD_FILES: + + &prompt.root; make -DBATCH_DELETE_OLD_FILES delete-old + + The same goal can be achieved by piping these commands + through yes: + + &prompt.root; yes|make delete-old + + Rebooting @@ -2637,6 +2703,49 @@ Script done, … then reboot the system using &man.shutdown.8;: &prompt.root; shutdown -r now + + + + Deleting obsolete libraries + + + Warning + + Deleting obsolete files will break applications that + still depend on those obsolete files. This is especially true + for old libraries. In most cases, the programs, ports, or + libraries that used the old library need to be recompiled + before make + delete-old-libs is + executed. + + + Utilities for checking shared library dependencies are + available from the Ports Collection in + sysutils/libchk or sysutils/bsdadminscripts. + + Obsolete shared libraries can conflict with newer libraries, + causing messages like these: + + /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 + + To solve these problems, determine which port installed the + library: + + &prompt.root; pkg_info -W /usr/local/lib/libtiff.so + /usr/local/lib/libtiff.so was installed by package tiff-3.9.4 + &prompt.root; pkg_info -W /usr/local/lib/libXext.so + /usr/local/lib/libXext.so was installed by package libXext-1.1.1,1 + + Then deinstall, rebuild and reinstall the port. ports-mgmt/portmaster can be used to + automate this process. After all ports are rebuilt and no + longer use the old libraries, delete the old libraries using the + following command: + + &prompt.root; make delete-old-libs You should now have successfully upgraded the &os; system. Congratulations. @@ -2921,111 +3030,6 @@ Building everything.. - - - - - Anton - Shterenlikht - Based on notes provided by - - - - Deleting Obsolete Files, Directories and Libraries - - - Deleting obsolete files, directories and - libraries - - - As a part of the &os; development lifecycle, files and their - contents occasionally become obsolete. This may be because - 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 - is that the system is not cluttered with old files which take up - unnecessary space on the storage and backup media. - Additionally, if the old library has a security or stability - issue, the system should be updated to the newer library to keep - it safe and to prevent crashes caused by the old library. - Files, directories, and libraries which are considered obsolete - are listed in /usr/src/ObsoleteFiles.inc. - The following instructions should be used to remove obsolete - files during the system upgrade process. - - Follow the steps outlined in . After the - make installworld - and the subsequent mergemaster have finished - successfully, check for obsolete files and libraries as - follows: - - &prompt.root; cd /usr/src -&prompt.root; make check-old - - If any obsolete files are found, they can be deleted using - the following command: - - &prompt.root; make delete-old - - - Refer to /usr/src/Makefile - for more targets of interest. - - - A prompt is displayed before deleting each obsolete file. - To skip the prompt and let the system remove these files - automatically, use - BATCH_DELETE_OLD_FILES: - - &prompt.root; make -DBATCH_DELETE_OLD_FILES delete-old - - The same goal can be achieved by piping these commands - through yes: - - &prompt.root; yes|make delete-old - - - Warning - - Deleting obsolete files will break applications that - still depend on those obsolete files. This is especially true - for old libraries. In most cases, the programs, ports, or - libraries that used the old library need to be recompiled - before make - delete-old-libs is - executed. - - - Utilities for checking shared library dependencies are - available from the Ports Collection in - sysutils/libchk or sysutils/bsdadminscripts. - - Obsolete shared libraries can conflict with newer libraries, - causing messages like these: - - /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 - - To solve these problems, determine which port installed the - library: - - &prompt.root; pkg_info -W /usr/local/lib/libtiff.so -/usr/local/lib/libtiff.so was installed by package tiff-3.9.4 -&prompt.root; pkg_info -W /usr/local/lib/libXext.so -/usr/local/lib/libXext.so was installed by package libXext-1.1.1,1 - - Then deinstall, rebuild and reinstall the port. ports-mgmt/portmaster can be used to - automate this process. After all ports are rebuilt and no - longer use the old libraries, delete the old libraries using the - following command: - - &prompt.root; make delete-old-libs - -