KISSFILT
Raw KISS/AX.25 Frame Filter

Description

KISSFILT removes unwanted frames from a file of raw KISS AX.25 frames. The input file format is simply a log of every byte sent to the computer from a KISS TNC. The output file is in the same format, but contains only the frames you want.

The filtering can be controlled interactively or by a filter specification file.

KISSFILT is a command-line program.

System Requirements

To run the included executable, any environment capable of running well-behaved MS-DOS programs, including all versions of Windows, OS/2, and most DOS emulation environments.

The program should also be portable to other command-line environments, such as Unix, but the interactive mode might take a little bit of effort to get working.

Features

Command-line program
Input and output is AX.25 L2 V1 or V2 with KISS framing
Filter by source and destination callsigns
Filter out all non-information frames
Filter by Protocol ID (pid)
Filter by Pacsat Broadcast Protocol file number
Accept or reject each source/destination pair interactively if you want
Or, specify all filtering criteria using a control file using regular expressions

Limitations

Doesn't try to decode any other higher-layer formats

Example

This is an interactive KISSFILT session using a KISS log file taken from the downlink of AO-16.

C:\tmp>kissfilt 92012905.kss foo.kss
KISSFILT - Filter a KISS log file by callsigns
 Version 1.3   2/17/92 Copyright 1991,1992 Paul Williamson KB5MU            

Would you like to use a filter file? [ynq] No
Scanning input KISS file...
Keep or discard packets from PACSAT-12 to WC5I     ? [kdq] Discard
Keep or discard packets from PACSAT-11 to PBLIST   ? [kdq] Discard
Keep or discard packets from PACSAT-12 to WJ9F     ? [kdq] Discard
Keep or discard packets from PACSAT-12 to WD0E     ? [kdq] Discard
Keep or discard packets from PACSAT-1  to TIME-1   ? [kdq] Keep
Keep or discard packets from PACSAT-1  to TLM      ? [kdq] Keep
Keep or discard packets from PACSAT-1  to STATUS   ? [kdq] Keep
Keep or discard packets from PACSAT-1  to LSTAT    ? [kdq] Keep
Keep or discard packets from PACSAT-12 to BBSTAT   ? [kdq] Discard
Keep or discard packets from PACSAT-12 to N5AHD-2  ? [kdq] Discard
Keep or discard packets from PACSAT-12 to KB6WYU   ? [kdq] Discard

C:\tmp>

Current Status

Stable. No current development plans. The current released version of KISSFILT is 1.3, released February 17, 1992.

History

Date?? - Initial release
17 February 1992 - version 1.3

Known Bugs

None.

Distribution

KISSFILT may be distributed freely (unmodified) and may be used freely for non-commercial purposes.

Source Code

Source code in ANSI C is included.

KISSFILT makes use of the regexp library routines provided by Henry Spencer (included).

Documentation

KISSFILT.TXT - user manual (plain text, 11K)

The KISS TNC: A simple Host-to-TNC communications protocol, the original 1987 paper by Mike Chepponis, K3MC, and Phil Karn, KA9Q.

AX.25 Amateur Packet-Radio Link-Layer Protocol specification

Pacsat Broadcast Protocol specifications

regexp README - documentation for the regexp package

Download

KISSFILT 1.3 (zip file, 63K)

KISSFILT Raw KISS/AX.25 Frame Filter