X-Git-Url: http://gitweb.michael.orlitzky.com/?p=hath.git;a=blobdiff_plain;f=hath.cabal;h=723c644cc56bdd5ce492591ca83aea0be64c0f37;hp=ca43858732c61b38f6c03fd456e0b67a04da64b5;hb=a2fe46950a637e64fb5056fce091bf398b983a79;hpb=041d33c0e5ac9c0e9733f42cd96aa2fba07a043f diff --git a/hath.cabal b/hath.cabal index ca43858..723c644 100644 --- a/hath.cabal +++ b/hath.cabal @@ -1,18 +1,113 @@ name: hath -version: 0.0 +version: 0.0.6 cabal-version: >= 1.8 author: Michael Orlitzky maintainer: Michael Orlitzky +category: Utils +license: GPL-3 +license-file: doc/LICENSE +build-type: Simple +extra-source-files: + doc/man1/hath.1 synopsis: Hath manipulates network blocks in CIDR notation. -build-type: Simple - +description: + Hath is a Haskell program for working with network blocks in CIDR + notation. When dealing with blocks of network addresses, there are a + few things that one usually wants to do with them: + . + * Create a regular expression matching the CIDR block(s). This is + because grep will throw up if you feed it CIDR. + . + * Combine small blocks into larger ones. For example, if you have two + consecutive \/24s, they might combine into a larger \/23. + . + * View the result of block combination in a useful way. + . + * List them. + . + * Find their associated PTR records. + . + Hath has several modes to perform these functions: + . + [@Regexed@] + This computes a (Perl-compatible) regular expression matching + the input CIDR blocks. It's the default mode of operation. + . + [@Reduced@] + This combines small blocks into larger ones where possible, and + eliminates redundant blocks. The output should be equivalent to + the input, though. + . + [@Duped@] + Shows only the blocks that would be removed by reduce; that is, it + shows the ones that would get combined into larger blocks or are + simply redundant. + . + [@Diffed@] + Shows what would change if you used reduce. Uses diff-like + notation. + . + [@Listed@] + List the IP addresses contained within the given CIDRs. + . + [@Reversed@] + Perform reverse DNS (PTR) lookups on the IP addresses contained + within the given CIDRs. + . + /Examples/: + . + Combine two \/24s into a \/23: + . + @ + $ hath reduced <<< \"10.0.0.0\/24 10.0.1.0\/24\" + 10.0.0.0/23 + @ + . + Create a perl-compatible regex to be fed to grep: + . + @ + $ grep -P `hath regexed -i cidrs.txt` mail.log + @ + . + List the addresses in 192.168.0.240\/29: + . + @ + $ hath listed <<< \"192.168.0.240\/29\" + 192.168.0.240 + 192.168.0.241 + 192.168.0.242 + 192.168.0.243 + 192.168.0.244 + 192.168.0.245 + 192.168.0.246 + 192.168.0.247 + @ + . + Perform PTR lookups on all of 198.41.0.4\/30: + . + @ + hath reversed <<< \"198.41.0.4\/30\" + 198.41.0.4: a.root-servers.net. + 198.41.0.5: + 198.41.0.6: rs.internic.net. + 198.41.0.7: + @ + . + The DNS lookups are usually the bottleneck for this mode, but we can + perform them in parallel. Simply pass the number of threads to the + GHC runtime on the command line; for example, the following will + perform 25 lookups in parallel: + . + @ + hath reversed +RTS -N25 <<< \"198.41.0.4\/24\" + 198.41.0.4: a.root-servers.net. + 198.41.0.5: + 198.41.0.6: rs.internic.net. + ... + @ executable hath - build-depends: - base == 4.4.*, - HUnit == 1.2.*, - QuickCheck == 2.4.* main-is: Main.hs @@ -20,6 +115,31 @@ executable hath hs-source-dirs: src/ + other-modules: + Bit + Cidr + CommandLine + DNS + ExitCodes + IPv4Address + Maskable + Maskbits + Octet + + build-depends: + base >= 4.6 && < 4.7, + bytestring == 0.10.*, + cmdargs == 0.10.*, + dns == 1.*, + HUnit == 1.2.*, + QuickCheck == 2.6.*, + MissingH == 1.2.*, + parallel-io == 0.3.*, + split == 0.2.*, + test-framework == 0.8.*, + test-framework-hunit == 0.3.*, + test-framework-quickcheck2 == 0.3.* + ghc-options: -Wall -fwarn-hi-shadowing @@ -31,9 +151,6 @@ executable hath -fwarn-incomplete-record-updates -fwarn-monomorphism-restriction -fwarn-unused-do-bind - -funbox-strict-fields - -fexcess-precision - -fno-spec-constr-count -rtsopts -threaded -optc-O3 @@ -44,3 +161,127 @@ executable hath -prof -auto-all -caf-all + + +test-suite testsuite + type: exitcode-stdio-1.0 + hs-source-dirs: src test + main-is: TestSuite.hs + + build-depends: + base >= 4.6 && < 4.7, + bytestring == 0.10.*, + cmdargs == 0.10.*, + dns == 1.*, + HUnit == 1.2.*, + QuickCheck == 2.6.*, + MissingH == 1.2.*, + parallel-io == 0.3.*, + split == 0.2.*, + test-framework == 0.8.*, + test-framework-hunit == 0.3.*, + test-framework-quickcheck2 == 0.3.* + + -- It's not entirely clear to me why I have to reproduce all of this. + ghc-options: + -Wall + -fwarn-hi-shadowing + -fwarn-missing-signatures + -fwarn-name-shadowing + -fwarn-orphans + -fwarn-type-defaults + -fwarn-tabs + -fwarn-incomplete-record-updates + -fwarn-monomorphism-restriction + -fwarn-unused-do-bind + -rtsopts + -threaded + -optc-O3 + -optc-march=native + -O2 + + +-- These won't work without shelltestrunner installed in your +-- $PATH. Maybe there is some way to tell Cabal that. +test-suite shelltests + type: exitcode-stdio-1.0 + hs-source-dirs: test + main-is: ShellTests.hs + + build-depends: + base >= 4.6 && < 4.7, + bytestring == 0.10.*, + cmdargs == 0.10.*, + dns == 1.*, + HUnit == 1.2.*, + QuickCheck == 2.6.*, + MissingH == 1.2.*, + parallel-io == 0.3.*, + process == 1.1.*, + split == 0.2.*, + test-framework == 0.8.*, + test-framework-hunit == 0.3.*, + test-framework-quickcheck2 == 0.3.* + + -- It's not entirely clear to me why I have to reproduce all of this. + ghc-options: + -Wall + -fwarn-hi-shadowing + -fwarn-missing-signatures + -fwarn-name-shadowing + -fwarn-orphans + -fwarn-type-defaults + -fwarn-tabs + -fwarn-incomplete-record-updates + -fwarn-monomorphism-restriction + -fwarn-unused-do-bind + -rtsopts + -threaded + -optc-O3 + -optc-march=native + -O2 + + +test-suite shelltests-net + type: exitcode-stdio-1.0 + hs-source-dirs: test + main-is: ShellTestsNet.hs + + build-depends: + base >= 4.6 && < 4.7, + bytestring == 0.10.*, + cmdargs == 0.10.*, + dns == 1.*, + HUnit == 1.2.*, + QuickCheck == 2.6.*, + MissingH == 1.2.*, + parallel-io == 0.3.*, + process == 1.1.*, + split == 0.2.*, + test-framework == 0.8.*, + test-framework-hunit == 0.3.*, + test-framework-quickcheck2 == 0.3.* + + -- It's not entirely clear to me why I have to reproduce all of this. + ghc-options: + -Wall + -fwarn-hi-shadowing + -fwarn-missing-signatures + -fwarn-name-shadowing + -fwarn-orphans + -fwarn-type-defaults + -fwarn-tabs + -fwarn-incomplete-record-updates + -fwarn-monomorphism-restriction + -fwarn-unused-do-bind + -rtsopts + -threaded + -optc-O3 + -optc-march=native + -O2 + + +source-repository head + type: git + location: http://michael.orlitzky.com/git/hath.git + branch: master