History log of /freebsd-current/tools/tools/README
Revision Date Author Comments
# d0b2dbfa 16-Aug-2023 Warner Losh <imp@FreeBSD.org>

Remove $FreeBSD$: one-line sh pattern

Remove /^\s*#[#!]?\s*\$FreeBSD\$.*$\n/


# b3087b63 15-May-2023 Wolfram Schneider <wosch@FreeBSD.org>

remove stale portsinfo script


# 1206aa27 15-May-2023 Wolfram Schneider <wosch@FreeBSD.org>

remove stale handbook scripts


# 27783115 15-May-2023 Wolfram Schneider <wosch@FreeBSD.org>

remove stale message-id scripts


# 1cf4473f 15-May-2023 Wolfram Schneider <wosch@FreeBSD.org>

remove stale script epfe.pl

tools/tools/epfe/epfe.pl was a perl script that formerly generated some
printing example files from content in a very old version of the handbook.

Reported by: wblock


# 5ffaf795 15-Mar-2022 Mateusz Piotrowski <0mp@FreeBSD.org>

tools/tools/README: Remove tinybsd entry

Fixes: 0c7a642ae8f5 tinybsd: Remove


# bbbefa33 16-Jul-2020 John-Mark Gurney <jmg@FreeBSD.org>

add script to help figure out what man pages need MLINKS updated...


# 592ffb21 23-Aug-2018 Warner Losh <imp@FreeBSD.org>

Revert drm2 removal.

Revert r338177, r338176, r338175, r338174, r338172

After long consultations with re@, core members and mmacy, revert
these changes. Followup changes will be made to mark them as
deprecated and prent a message about where to find the up-to-date
driver. Followup commits will be made to make this clear in the
installer. Followup commits to reduce POLA in ways we're still
exploring.

It's anticipated that after the freeze, this will be removed in
13-current (with the residual of the drm2 code copied to
sys/arm/dev/drm2 for the TEGRA port's use w/o the intel or
radeon drivers).

Due to the impending freeze, there was no formal core vote for
this. I've been talking to different core members all day, as well as
Matt Macey and Glen Barber. Nobody is completely happy, all are
grudgingly going along with this. Work is in progress to mitigate
the negative effects as much as possible.

Requested by: re@ (gjb, rgrimes)


# d494a4a7 21-Aug-2018 Matt Macy <mmacy@FreeBSD.org>

r338172 followup - removal of stray drm references


# 6f78fad3 17-May-2018 Sean Bruno <sbruno@FreeBSD.org>

Retire vxge(4).

This driver was merged to HEAD one week prior to Exar publicly announcing they
had left the Ethernet market. It is not known to be used and has various code
quality issues spotted by Brooks and Hiren. Retire it in preparation for
FreeBSD 12.0.

Submitted by: kbowling
Reviewed by: brooks imp
Relnotes: yes
Sponsored by: Limelight Networks
Differential Revision: https://reviews.freebsd.org/D15442


# 36730a25 15-May-2018 Ed Maste <emaste@FreeBSD.org>

Add intel-ucode-split to tools README


# 57b49365 08-May-2018 Sean Bruno <sbruno@FreeBSD.org>

nxge(4):
Remove nxge(4) and associated man page and tools in FreeBSD 12.0.

Submitted by: kbowling
Reviewed by: brooks
Relnotes: yes
Sponsored by: Limelight Networks
Differential Revision: https://reviews.freebsd.org/D1529


# 818cd846 18-Apr-2018 Ed Maste <emaste@FreeBSD.org>

Remove mention of tools/recoverdisk, now in sbin

PR: 227570
MFC after: 3 days


# 8d6a5512 27-Jan-2018 Eitan Adler <eadler@FreeBSD.org>

tools: remove note about diffburst.

Said tool was removed in 1999 in r51579


# 252b793a 20-Oct-2016 Ryan Stone <rstone@FreeBSD.org>

Add some tools to simplify the use of git

Add some scripts that wraps some FreeBSD Project infrastructure
and simplifies using them with git. The scripts are:

- arcgit, which creates a series of reviews in Differential
- importgit, which applies a series of git commits to svn

Differential Revision: https://reviews.freebsd.org/D2071


# 10ac2033 25-Nov-2015 Hans Petter Selasky <hselasky@FreeBSD.org>

Add simple indent wrapper tool for style(9) checking GIT/SVN patches.
The indent_wrapper tool only accepts full context diffs and works by
identifying the surrounding C-block touched by a diff and passing only
that to indent for styling. In the end a diff is produced or an
external tool like meld can be invoked, to show the styling
differences.


# 87244293 22-Jun-2014 Gavin Atkinson <gavin@FreeBSD.org>

With the migration from GNATS to Bugzilla, we no longer need a tool to
graph GNATS PR statistics. It would be nice to have a similar tool for
the new bug database, but that would likely be a from-scratch rewrite.


# a435cf5c 24-Aug-2013 Jean-Sébastien Pédron <dumbbell@FreeBSD.org>

drm: Update drm_pciids.h based on Linux 3.8

This header can be easily updated using the new "gen-drm_pciids" script,
available in tools/tools/drm. The script uses the Linux' drm_pciids.h
header for new IDs, the FreeBSD's one because we add the name of the
device to each IDs, and the PCI IDs database (misc/pciids port) to fill
this name automatically for new IDS.

To call the script:
tools/tools/drm/gen-drm_pciids \
/path/to/linux/drm_pciids.h \
/path/to/freebsd/drm_pciids.h \
/path/to/pciids/pci.ids


# 2ab4fdc4 13-Sep-2012 Eitan Adler <eadler@FreeBSD.org>

Remove scripts and tools which only functioned when src was using CVS

Approved by: cperciva
MFC after: 1 week


# 68b8534b 16-Nov-2011 Luigi Rizzo <luigi@FreeBSD.org>

Bring in support for netmap, a framework for very efficient packet
I/O from userspace, capable of line rate at 10G, see

http://info.iet.unipi.it/~luigi/netmap/

At this time I am bringing in only the generic code (sys/dev/netmap/
plus two headers under sys/net/), and some sample applications in
tools/tools/netmap. There is also a manpage in share/man/man4 [1]

In order to make use of the framework you need to build a kernel
with "device netmap", and patch individual drivers with the code
that you can find in

sys/dev/netmap/head.diff

The file will go away as the relevant pieces are committed to
the various device drivers, which should happen in a few days
after talking to the driver maintainers.

Netmap support is available at the moment for Intel 10G and 1G
cards (ixgbe, em/lem/igb), and for the Realtek 1G card ("re").
I have partial patches for "bge" and am starting to work on "cxgbe".
Hopefully changes are trivial enough so interested third parties
can submit their patches. Interested people can contact me
for advice on how to add netmap support to specific devices.

CREDITS:
Netmap has been developed by Luigi Rizzo and other collaborators
at the Universita` di Pisa, and supported by EU project CHANGE
(http://www.change-project.eu/)
The code is distributed under a BSD Copyright.

[1] In my opinion is a bad idea to have all manpage in one directory.
We should place kernel documentation in the same dir that contains
the code, which would make it much simpler to keep doc and code
in sync, reduce the clutter in share/man/ and incidentally is
the policy used for all of userspace code.
Makefiles and doc tools can be trivially adjusted to find the
manpages in the relevant subdirs.


# 223eb00d 10-Aug-2011 Navdeep Parhar <np@FreeBSD.org>

Move cxgbtool from usr.sbin to tools/tools.

Approved by: re (kib)
MFC after: 1 month


# 8a6a6922 09-Jun-2011 Navdeep Parhar <np@FreeBSD.org>

cxgbetool: a tool for the cxgbe(4) driver.


# 3c31540d 28-Apr-2011 George V. Neville-Neil <gnn@FreeBSD.org>

A diagnostic tool to go along with the vxge(4) 10GbE driver.
This tool can be used to print statistics, registers, and
other device specific information once the driver is loaded
into the kernel.

Submitted by: Sriram Rapuru from Exar
MFC after: 2 weeks


# a7d5f7eb 19-Oct-2010 Jamie Gritton <jamie@FreeBSD.org>

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.


# fe0506d7 09-Mar-2010 Marcel Moolenaar <marcel@FreeBSD.org>

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.


# 9516bdf1 24-Dec-2009 John Baldwin <jhb@FreeBSD.org>

Add a new tool which attempts to check for kernel configuration options that
are missing from NOTES files.


# c048da96 05-Jun-2009 Marko Zec <zec@FreeBSD.org>

Add an interim userland utility for managing vimages / virtualized
network stack infrastructure.

Requested by: julian (mentor)
Approved by: julian (mentor)


# 05c3c371 01-Jun-2009 Sam Leffler <sam@FreeBSD.org>

tools for mwl driver


# fc4c0664 23-May-2009 Sam Leffler <sam@FreeBSD.org>

add npe tools; first is npestats which reports device statistics


# 8c8e796b 23-May-2009 Edwin Groothuis <edwin@FreeBSD.org>

Added two tools to check the contents of /usr/share/misc/iso* with
the data from the sources.

PR: misc/127430 and misc/misc/127428


# 364eb2b1 05-Feb-2009 Sam Leffler <sam@FreeBSD.org>

add cfi test tool

Sponsored by: Carlson Wireless
Reviewed by: imp, Chris Andreson


# e39eeac7 23-Dec-2008 George V. Neville-Neil <gnn@FreeBSD.org>

Add a new program, ether_reflect, which is useful in testing ethernet
devices and switches.


# b638482b 23-Dec-2008 George V. Neville-Neil <gnn@FreeBSD.org>

Add the mctest program and description to the README.


# d7f03759 19-Oct-2008 Ulf Lilleengen <lulf@FreeBSD.org>

- Import the HEAD csup code which is the basis for the cvsmode work.


# 366ad76c 05-Apr-2008 Ceri Davies <ceri@FreeBSD.org>

Correct typo.


# 91ad87ed 20-Mar-2008 Dag-Erling Smørgrav <des@FreeBSD.org>

"track" is a script I've used for ages to track the progress of a build.
Unlike whereintheworld, it continuously monitors the log file; it also
produses less verbose output.


# fd3ddbd0 29-Jun-2007 Sam Leffler <sam@FreeBSD.org>

Neterion Xframe 10GbE Server/Storage adapter driver.

The nxge driver provides support for Neterion Xframe-I and Xframe-II
adapters. The driver supports TCP Segmentation Offload (TSO/LSO),
Jumbo frames (5 buffer mode), Header separation (2 and 3 Receive
buffer modes), VLAN, and Promiscuous mode.

Submitted by: Neterion
Reviewed by: rwatson
Approved by: re (kensmith)


# 14dd02e1 02-Mar-2007 Bruce M Simpson <bms@FreeBSD.org>

Put this old tool for dumping PCI expansion ROM images somewhere useful.

WARNING: THIS IS NOT STABLE ON NON-I386 ARCHITECTURES, AND NEEDS SPECIFIC
KNOWLEDGE OF THE ADDRESS SPACE ON YOUR SYSTEM TO WORK.


# 1474f88f 20-Sep-2006 Julian Elischer <julian@FreeBSD.org>

In the spirit of nanoBSD and PicoBSD, add TinyBSD.
Submitted by jmeloatfreebsdbrasil,com-br
(Jean Milanez Melo)
As PicoBSD becomes slightly less useful, TinyBSD fills the gap below nanoBSD.


# a7a8b22f 30-May-2006 Dag-Erling Smørgrav <des@FreeBSD.org>

The tinderbox has moved to projcvs.


# ed7b0743 22-Feb-2006 Sam Leffler <sam@FreeBSD.org>

test program to check cpu counting

MFC after: 1 week


# d44231a0 13-Dec-2005 Dag-Erling Smørgrav <des@FreeBSD.org>

Add a script that converts K&R-style function definitions to ANSI style.


# a845c77d 03-Dec-2005 Ruslan Ermilov <ru@FreeBSD.org>

Move the 2->3 upgrade kit on the attic.


# 57bbb41e 07-Oct-2005 Damien Bergamini <damien@FreeBSD.org>

Import iwi-specific tools. Can help debug firmware or connection issues.


# d1c48a07 17-Sep-2005 Christian S.J. Peron <csjp@FreeBSD.org>

Remove reference to bpfstat, this no longer exists.


# 914aa01c 26-Jul-2005 Christian S.J. Peron <csjp@FreeBSD.org>

Add a description for bpfstat


# a09b2401 05-Jun-2005 Maxim Sobolev <sobomax@FreeBSD.org>

Add entry for recoverdisk.


# 74c77551 12-Apr-2005 Tai-hwa Liang <avatar@FreeBSD.org>

Adding a brief description for pirtool.

Reviewed by: sam (mentor)


# 085eeed7 28-Feb-2005 Tom Rhodes <trhodes@FreeBSD.org>

Add sysdoc, a small set of scripts which will parse a kernel binary and
modules to rip out the available sysctls. It will then produce a manual
page which may be installed with 'make install'. Currently typing 'make'
in the directory uses the default /boot/kernel files. To use a specific
directory, run sysdoc -k [location].


# 542c24f0 07-Dec-2004 Pawel Jakub Dawidek <pjd@FreeBSD.org>

Raidtest is now in the ports collections.


# 6f0027bc 17-Oct-2004 Maxim Konovalov <maxim@FreeBSD.org>

Fix a typo: s/kerncruft/kernelcruft/.

PR: misc/72792
Submitted by: Hywel Mallett


# c33b0bc0 24-Sep-2004 John-Mark Gurney <jmg@FreeBSD.org>

add my script that helps me handle MFC's. It takes in a commit message
and generates the proper (hopefully) update -j lines + commit line to do
the MFC... This has saved me a lot of time doing recent MFC's...

You still should use diff to verify the changes before doing the commit..


# 2c289a3f 24-Sep-2004 Dag-Erling Smørgrav <des@FreeBSD.org>

Add mfc.


# 90fcc4b3 28-Aug-2004 Dag-Erling Smørgrav <des@FreeBSD.org>

Add genericize, a Perl script that converts a kernel config into something
more easily diffable against GENERIC.


# 91fa7ba6 20-Aug-2004 Pawel Jakub Dawidek <pjd@FreeBSD.org>

Add description of raidtest tool.


# 1d559da4 28-Mar-2004 Marcel Moolenaar <marcel@FreeBSD.org>

Add a simple tool that prints out a register offset table to map
from the gdb(1) register number to offsets within struct reg and
struct fpreg. The tool is useful only on selected platforms. On
ia64 the registers are all over the place to simplify handling of
them in various situations, but which makes creating or maintaining
such an offset table error prone to do by hand.
Since remote kernel debugging operates on the same register numbers,
it would be a natural choice to use an identical offset table in the
kernel. However, since the kernel does not operate on struct reg nor
struct fpreg in the remote gdb(1) case, such would not make sense.
Whether we want to use this tool to create offsets for use in the
kernel or duplicate the knowledge of which register number maps to
what register is something that will become clear soon.

Note: in order to build cross debuggers, one cannot use target
headers and/or target definitions. That's why offsets need to be
hardcoded in the first place. Unpleasant, but necessary.


# 891ea87e 12-Nov-2003 Sam Leffler <sam@FreeBSD.org>

add in-kernel ttcp performance tool


# 503148a2 05-Aug-2003 Dag-Erling Smørgrav <des@FreeBSD.org>

Add a comment about hcomp.


# 64125f98 28-Jun-2003 Sam Leffler <sam@FreeBSD.org>

bring in ath-specific test tool; more to follow


# d61fae84 31-Jan-2003 Sean Chittenden <seanc@FreeBSD.org>

Add a getopt-ified version of an old tool that I've been using for ages:
backout_commit.rb. Tool can be used to automate the
process of backing out either small or large commits based off of
one or more commit messages. The result of the script is a shell
script which can be edited or run as needed. New and dead files
are taken into consideration. See the program's usage statement for
more configuration details. Here's an example usage:

<programlisting>
$ mutt
[find commit message, save to disk as cvsmsg.txt]
$ backout_commit.rb ~/cvsmsg.txt
Backout directory: /usr
Backout script: backout-2003-01-31-14-04.sh

Scanning through cvsmsg.txt...done.

Change to /usr and run this script. Please look through this script and
make changes as necessary. There are commented out commands available
in the script.

Example script usage:
mv backout-2003-01-31-14-04.sh /usr
cd /usr
less backout-2003-01-31-14-04.sh
/bin/sh backout-2003-01-31-14-04.sh
rm -f backout-2003-01-31-14-04.sh
</programlisting>


# 130b4687 09-Jan-2003 Jens Schweikhardt <schweikh@FreeBSD.org>

Fix a useless use of cat. Save a process today.


# a25cc4a3 08-Jan-2003 Dag-Erling Smørgrav <des@FreeBSD.org>

Document tinderbox and whereintheworld, and move diffburst in its
alphabetical place.


# 5df0c0ea 13-Dec-2002 Sam Leffler <sam@FreeBSD.org>

add program used to exercise/test /dev/crypto symmetric crypto functionality

Obtained from: openbsd (originally)


# 92d0f599 03-Oct-2002 Garrett Wollman <wollman@FreeBSD.org>

Yesterday, FreeBSD-current ate my disklabel.
Today, I wrote a program to tell me where the partitions used to be.
Now I have my /media filesystem back.


# d4f5290e 15-Apr-2002 Dag-Erling Smørgrav <des@FreeBSD.org>

Long-forgotten patch: list prstats


# 49ae32af 28-Feb-2002 Josef Karthauser <joe@FreeBSD.org>

Add a tool that I've written to help with finding what other
files/revisions were changed with a particular commit.


# a320ca2f 22-Nov-2001 Sheldon Hearn <sheldonh@FreeBSD.org>

Add the script that will be used to maintain src/share/misc/pci_vendors.
The script written and used originally by msmith has been lost.

This version takes the Boemler and Heckenbach lists and produces merged
output. It defaults to ignoring any entries from Heckenbach already
found in Boemler but the -l option causes it to take the entry with the
longest description where an entry appears in both lists.

If this script is replaced, care should be taken to

1) Always use upper-case hexidecimal tokens in device ids.

2) Always keep device lists sorted within vendor lists, which must also
be sorted.

3) Do not try to include input from the previous pci_vendors file, since
bogus ids seem to be removed from both the Boemler and Heckenbach
lists from time to time.


# c8ac4faa 05-Nov-2001 Poul-Henning Kamp <phk@FreeBSD.org>

Update.


# 456b2f80 11-Oct-1999 Poul-Henning Kamp <phk@FreeBSD.org>

Add the machine that goes "BINGO" every time an potentially
unused #include is spotted in the kernel sources.

(This commit message celebrates Monty Pythons 30year aniversary)


# 32e29e45 22-Sep-1999 Archie Cobbs <archie@FreeBSD.org>

Remove the "diffburst" tool, because equivalent functionality is now available
via "split -p". Leave a note to this effect in the README file.


# c3aac50f 27-Aug-1999 Peter Wemm <peter@FreeBSD.org>

$Id$ -> $FreeBSD$


# 740e54be 07-Jan-1999 Archie Cobbs <archie@FreeBSD.org>

Add the 'diffburst' tool, which does the following:
Reads the output of 'diff -r' and splits it into separate
patch files, one per file. The files are named 'patch-XX'
where XX is aa, ab, ac, ... Useful when creating ports.


# 36cabb92 16-Dec-1998 Martin Cracauer <cracauer@FreeBSD.org>

Actually document my last addition.
General cosmetics.
Add a note that scsi-defects has not been ported to CAM.
Submitted by: BDE


# 37fcb387 15-Dec-1998 Martin Cracauer <cracauer@FreeBSD.org>

Add some emacs code to make cc-mode almost compatible to style(9).
Sort entries in toplevel README.


# 67698083 08-Sep-1998 John Birrell <jb@FreeBSD.org>

Add a note about the upgrade tool directory.


# e402641e 20-May-1998 Wolfram Schneider <wosch@FreeBSD.org>

Add mid scripts. Mid is a tool which create a Message-ID database
for mailing lists.


# 9350872a 09-Nov-1997 Wolfram Schneider <wosch@FreeBSD.org>

Add html-mv script. Html-mv rename HTML generated filenames to
human readable filenames. E.g.:

$ cd FAQ
$ make FORMATS=html
$ html-mv FAQ
$ ls
FAQ_ACKNOWLEDGMENTS.html
FAQ_Any_restrictions_on_how_I_divide_the_disk_up_.html
FAQ_Are_there_any_Database_systems_for_FreeBSD_.html
FAQ_Are_there_any_commercial_high-performance_X_servers_.html
FAQ_Books_on_FreeBSD.html
FAQ_Can_FreeBSD_handle_multiport_serial_cards_sharing_irqs_.html
[...]


# 52b8453b 25-Apr-1997 Wolfram Schneider <wosch@FreeBSD.org>

Add portsinfo, which generate list of new ports for last two weeks.


# b97fa2ef 22-Feb-1997 Peter Wemm <peter@FreeBSD.org>

Revert $FreeBSD$ to $Id$


# a58538e0 02-Feb-1997 Joerg Wunsch <joerg@FreeBSD.org>

Add a tools to get at the primary or grown defect list of a SCSI disk.

Submitted by: dufault


# b8785226 21-Jan-1997 Mike Smith <msmith@FreeBSD.org>

Add KernelDriver.


# 1130b656 14-Jan-1997 Jordan K. Hubbard <jkh@FreeBSD.org>

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# fa2cedd4 28-Dec-1996 Wolfram Schneider <wosch@FreeBSD.org>

add epfe and tcl_bmake


# 7633b004 11-Oct-1996 Garrett Wollman <wollman@FreeBSD.org>

Actually tell people what ifinfo is.


# ec6708b4 15-Oct-1995 Poul-Henning Kamp <phk@FreeBSD.org>

Add kernxref, a shellscript to crossreference the symbols of the LINT kernel.


# 7785b56d 15-Oct-1995 Poul-Henning Kamp <phk@FreeBSD.org>

README reads:
This directory is for tools.

A tool is something which is sometimes useful, and doesn't fit any of the
other categories.

Please make a subdir per program, and add a brief description to this file.