FreeBSD Handbook
Prev | Chapter 24 Updating and Upgrading FreeBSD | Next

# 24.3 Portsnap: A Ports Collection Update Tool

Written by Tom Rhodes. Based on notes provided by Colin Percival.

The base system of FreeBSD includes a utility for updating the Ports Collection too: the portsnap(8) utility. Upon execution, it will connect to a remote site, verify the secure key, and download a new copy of the Ports Collection. The key is used to verify the integrity of all downloaded files, ensuring they have not been modified in-flight. To download the latest Ports Collection files, issue the following command:

    # portsnap fetch
    Looking up portsnap.FreeBSD.org mirrors... 3 mirrors found.
    Fetching snapshot tag from portsnap1.FreeBSD.org... done.
    Fetching snapshot metadata... done.
    Updating from Wed Aug  6 18:00:22 EDT 2008 to Sat Aug 30 20:24:11 EDT 2008.
    Fetching 3 metadata patches.. done.
    Applying metadata patches... done.
    Fetching 3 metadata files... done.
    Fetching 90 patches.....10....20....30....40....50....60....70....80....90. done.
    Applying patches... done.
    Fetching 133 new ports or files... done.

What this example shows is that portsnap(8) has found and verified several patches to the current ports data. This also indicates that the utility was run previously, if it was a first time run, the collection would have simply been downloaded.

When portsnap(8) successfully completes a `fetch` operation, the Ports Collection and subsequent patches exist on the local system that have passed verification. The updated files may be installed by typing:

    # portsnap extract
    /usr/ports/.cvsignore
    /usr/ports/CHANGES
    /usr/ports/COPYRIGHT
    /usr/ports/GIDs
    /usr/ports/KNOBS
    /usr/ports/LEGAL
    /usr/ports/MOVED
    /usr/ports/Makefile
    /usr/ports/Mk/bsd.apache.mk
    /usr/ports/Mk/bsd.autotools.mk
    /usr/ports/Mk/bsd.cmake.mk
    ...

The process is now complete, and applications may be installed or upgraded using the updated Ports Collection.

To run both processes consecutively, issue the following command:

    # portsnap fetch update

Prev | Home | Next
FreeBSD Update | Up | Updating the Documentation Set

This, and other documents, can be downloaded from ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

For questions about FreeBSD, read the documentation before contacting <questions@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.