Add a section to the FreeBSD handbook on how to use the kismet software to debug WI-FI problems based on instructions from a wiki page FreeBSD
Status: Closed Time to complete: 72 hrs Mentors: Jakub Klama Tags: WiFi, DocBook, documentation, SGML, wireless, kismet, FreeBSD

Description of task

There are instructions in the FreeBSD wiki to help users debug WI-FI connections using the kismet software available in the ports collection: This information would be useful to our userbase to troubleshoot problems they might encounter with different WI-FI adapters/drivers/connections. This information needs to be added to the FreeBSD handbook or an appropriate preexisting article on WI-FI. The information added in that way needs to conform to FreeBSD's documentation formatting and style guidelines described in the FreeBSD documentation primer:

Task requires:

A FreeBSD system (in a VirtualBox Virtual Machine) installed on your computer. 
Knowledge of the documentation guidelines for the FreeBSD project:
Check out a copy of the documentation tree from the documentation repository to get the source code for the chapter

Uploaded Work
File name/URL File size Date submitted
handbook-kismet.diff 2.3 KB December 12 2011 23:49 UTC
Liezl on November 30 2011 22:57 UTC 404 Not Found

 The links:  display a 404 not found error

Wojciech A. Koszek on November 30 2011 23:11 UTC Link corrected.

That's the correct link (no space at the end)



Liezl on December 1 2011 22:35 UTC Task

For this task, do you have to write an in depth tutorial, or just copy what is on that wiki page into the handbook?

Wojciech A. Koszek on December 2 2011 07:03 UTC Repply


If possible, please verify that what is on the Wiki actually works. Other than that,

feel free to extent the information from the wiki.


Contact us before starting maybe. Tell us which system do you use on your desktop/laptop maybe and something about your background.


Have you ever used Wi-fi stuff in *nix systems? 


For e-mail contact with us:,

For IRC channel #freebsd-soc (Efnet). Our nicknames: wkoszek, jceel.





issyl0 on December 10 2011 14:18 UTC Task Claimed

I would like to work on this task.

Benedict Reuschling on December 10 2011 18:05 UTC Task Assigned

This task has been assigned to issyl0. You have 72 hours to complete this task, good luck!

issyl0 on December 12 2011 23:50 UTC Ready for review

The work on this task is ready to be reviewed.

issyl0 on December 13 2011 00:00 UTC My work on this task.


I've done as much as I can on this task.  I was asked to add more to it, about how Kismet actually works, but found I couldn't, due to not being able to configure my only wireless-enabled machine.  The task did only say that we needed FreeBSD in a VM and the doc tree, so not actually that 'real' hardware would be required (such as wireless adapters etc.). 


Melange on December 13 2011 18:05 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Wojciech A. Koszek on December 14 2011 06:13 UTC Task Closed

Congratulations, this task has been completed successfully.