GSoC/GCI Archive
Google Code-in 2011 FreeBSD

Create a FreeBSD ports/packages cheat sheet

completed by: doctorkohaku

mentors: Benedict Reuschling, Eitan Adler

Description of task
The FreeBSD ports collection provides an easy way for installing, configuring and updating third party software like text editors, browsers, multimedia applications, servers, etc. on the FreeBSD operating system. The objective of this task is to create a cheat sheet for our users that contains all the neccessary information to use the ports collection for daily tasks. This cheat sheet is intended to be handed out at FreeBSD booths or to be printed at home. As such, the sheet not only needs to have listings of the required commands the user has to enter, but also a short description (as short as possible) to understand what the command does. The layout for the cheat sheet is up to the participant and can be coordinated with the task mentors. The sheet should cover the following areas (preferably in that order):

  • Short description what ports/packages are
  • Installing and updating the ports collection (using portsnap)
  • Finding ports using (make search ...)
  • Installing a port/package
  • Configuring a port using make config
  • Running security checks on installed ports
  • Updating installed ports (using portmaster and portupgrade)
  • Reporting ports problems
  • Links for further information like, the ports PR database, etc.

The following page in the FreeBSD handbook contains most of the required information:

Task Requirements

Students are encouraged to use a FreeBSD system like our VirtualBox image to test the procedure, but can also use the information available online.

Please read before accepting this task, as it contains further details on what this task consists of, as well as providing useful information on how to obtain the page source and how to proceed with the task.