diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml index 9fa0995c28..a5d0479b5a 100644 --- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -172,6 +172,8 @@ + To keep track of updated ports, subscribe to + freebsd-ports. The remainder of this chapter will explain how to use packages and ports to install and manage third party software on FreeBSD. @@ -216,40 +218,154 @@ - - * Using the Packages System + + Using the Packages System + Contributed by &a.chern;, April 30, 2001. + Installing a Package - After you have decided which application you want to install you - need to download the package file and install it. - - There are several ways you can do this. + You can use the &man.pkg.add.1; utility to install a + FreeBSD software package from a local file or from a server on + the network. - Downloading and installing in multiple steps + Downloading a package and then installing it locally - + &prompt.root; ftp ftp2.freebsd.org +Connected to ftp2.freebsd.org. +220 ftp2.freebsd.org FTP server (Version 6.00LS) ready. +331 Guest login ok, send your email address as password. +230- +230- This machine is in Vienna, VA, USA, hosted by Verio. +230- Questions? E-mail freebsd@vienna.verio.net. +230- +230- +230 Guest login ok, access restrictions apply. +Remote system type is UNIX. +Using binary mode to transfer files. +ftp> cd /pub/FreeBSD/ports/packages/irc +250 CWD command successful. +ftp> get xchat-1.7.1.tgz +local: xchat-1.7.1.tgz remote: xchat-1.7.1.tgz +150 Opening BINARY mode data connection for 'xchat-1.7.1.tgz' (471488 bytes). +100% |**************************************************| 460 KB 00:00 ETA +226 Transfer complete. +471488 bytes received in 5.37 seconds (85.70 KB/s) +ftp> exit +&prompt.root; pkg_add xchat-1.7.1.tgz +&prompt.root; + + + If you don't have a source of local packages (such as a + FreeBSD CD-ROM set) then it will probably be easier to use the + -r option to &man.pkg.add.1;. This will cause the utility to + automatically determine the correct object format and release + and then to fetch and install the package from an FTP site. + + + &prompt.root; pkg_add -r xchat-1.7.1 + + + This would download the correct package and add it without + any further user intervention. + + Package files are distributed in .tgz format. You can + find them at ftp://ftp.freebsd.org/ports/packages, + or on the FreeBSD CD-ROM distribution. Every CD on the + FreeBSD 4-CD set (and PowerPak, etc) contains packages in + the /packages directory. The layout of + the packages is similar to that of the + /usr/ports tree. Each category has its + own directory, and every package can be found within the + All directory. + + + The directory structure of the package system is homologous + to that of the ports; they work with each other to form the entire + package/port system. + + Deleting a Package - - + &prompt.root pkg_delete xchat-1.7.1 +&prompt.root + + &man.pkg.delete.1; is the utility for removing + previously installed software package distributions. + - Updating a Package + Managing packages - + &man.pkg.info.1; a utility that lists and describes + the various packages installed. + + + &prompt.root pkg_info +cvsup-bin-16.1 A general network file distribution system optimized for CV +docbook-1.2 Meta-port for the different versions of the DocBook DTD +... + + &man.pkg.version.1; a utility that summarizes the + versions of all installed packages. It compares the package + version to the current version found in the ports tree. + + &prompt.root pkg_version +cvsup-bin = +docbook = +... + + + The symbols in the second column indicate the relative age + of the installed version and the version available in the local + ports tree. + + + + + + = The version of the + installed package matches that of the one found in the + local ports tree. + + + < + The installed version is older then the one available + in the ports tree. + + + >The installed version is newer + than the one found in the local ports tree. (local ports + tree is probably out of date) + + ?The installed package cannot be + found in the ports index. + + *There are multiple versions of the + package. + + + + - - - + Miscellaneous + &man.pkg.add.1; &man.pkg.delete.1; &man.pkg.info.1; + &man.pkg.version.1; &man.pkg.create.1; + + All package information is stored within the + /var/db/pkg directory. The listing + of contents and descriptions of each package can be found within + files in this directory. +