KISSFILT
Raw KISS/AX.25 Frame Filter

Must Be Art > Software > KISSFILT


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

Limitations

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

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)


Copyright 2002 Paul Williamson. Comments to kb5mu@amsat.org