Skip to content

BUILD_DEBIAN.md

Latest commit

 

History

History
101 lines (78 loc) · 2.62 KB

BUILD_DEBIAN.md

File metadata and controls

101 lines (78 loc) · 2.62 KB
Raw

Building Waymap Debian Package for Kali Linux

Prerequisites

On a Debian/Kali Linux system, install the required build dependencies:

sudo apt update
sudo apt install debhelper dh-python python3-all python3-setuptools python3-pkg-resources python3-sphinx

Building the Package

  1. Set executable permissions (Linux only):
chmod +x debian/rules
chmod +x debian/waymap.postinst
chmod +x debian/waymap.prerm
  1. Build the package:
dpkg-buildpackage -us -uc

This will create the following files in the parent directory:

  • waymap_8.2.0-1_all.deb - The main Debian package
  • waymap_8.2.0-1.debian.tar.xz - Debian packaging files
  • waymap_8.2.0-1.dsc - Package source description
  • waymap_8.2.0.orig.tar.gz - Original source tarball
  1. Install the package:
sudo dpkg -i ../waymap_8.2.0-1_all.deb

If there are dependency issues:

sudo apt-get install -f

Testing the Installation

After installation, verify it works:

waymap --version
waymap --help

Package Structure

The package installs files to the following locations:

  • /usr/bin/waymap - Main executable
  • /usr/lib/python3/dist-packages/waymap/ - Python package
  • /usr/share/waymap/ - Data files, payloads, config
  • /usr/share/doc/waymap/ - Documentation
  • /usr/share/man/man1/waymap.1 - Man page
  • /etc/waymap/ - Configuration directory

Kali Linux Submission

To submit to Kali Linux repository:

  1. Create a git repository:
git init
git add .
git commit -m "Initial Debian packaging for waymap"

  1. Follow Kali packaging guidelines:

    • Ensure the package meets Kali's packaging standards
    • Test thoroughly on Kali Linux
    • Check for security vulnerabilities in the package itself

  2. Submit via Kali's bug tracker or follow their contribution guidelines:

Compliance Checklist

  • Proper debian/control with correct dependencies
  • debian/copyright with GPL-3.0 license
  • debian/changelog with proper format
  • debian/rules using pybuild
  • Man page included
  • Post-installation scripts
  • Proper file permissions
  • Standards-Version 4.6.2
  • Source format 3.0 (quilt)
  • Watch file for automatic updates
  • README.Debian with instructions

Notes

  • The package uses dh-python with pybuild for Python 3
  • All dependencies are properly declared in debian/control
  • The package is architecture: all (pure Python)
  • AI features are optional (Recommends: python3-openai)
  • Security scanner tools are properly categorized in Section: net