name: hath
-version: 0.2.1
+version: 0.4.2
cabal-version: >= 1.8
author: Michael Orlitzky
maintainer: Michael Orlitzky <michael@orlitzky.com>
+homepage: http://michael.orlitzky.com/code/hath.xhtml
category: Utils
-license: GPL-3
+license: AGPL-3
license-file: doc/LICENSE
build-type: Simple
extra-source-files:
doc/man1/hath.1
test/shell/*.test
- test/shell-net/*.test
synopsis:
Hath manipulates network blocks in CIDR notation.
description:
* 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:
.
.
[@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/:
.
the input CIDR blocks. It's the default mode of operation.
.
@
- $ hath <<< \"10.0.0.0\/29 10.0.0.8\/29\"
+ $ echo \"10.0.0.0\/29 10.0.0.8\/29\" | hath
((10)\.(0)\.(0)\.(15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0))
@
.
Combine two \/24s into a \/23:
.
@
- $ hath reduced <<< \"10.0.0.0\/24 10.0.1.0\/24\"
+ $ echo \"10.0.0.0\/24 10.0.1.0\/24\" | hath reduced
10.0.0.0/23
@
.
List the addresses in 192.168.0.240\/29:
.
@
- $ hath listed <<< 192.168.0.240\/29
+ $ echo 192.168.0.240\/29 | hath listed
192.168.0.240
192.168.0.241
192.168.0.242
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.
- ...
- @
- .
The command-line syntax and complete set of options are documented in
the man page.
Bit
Cidr
CommandLine
- DNS
ExitCodes
IPv4Address
Maskable
Octet
build-depends:
- base >= 4.6 && < 4.8,
- bytestring == 0.10.*,
- cmdargs == 0.10.*,
- dns >= 1.2,
- MissingH == 1.2.*,
- parallel-io == 0.3.*,
- split == 0.2.*,
- tasty == 0.8.*,
- tasty-hunit == 0.8.*,
+ base >= 4.9 && < 5,
+ cmdargs >= 0.10,
+ split >= 0.2,
+ tasty >= 0.8,
+ tasty-hunit >= 0.8,
tasty-quickcheck >= 0.8.1
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
+ -Weverything
+ -Wno-implicit-prelude
+ -Wno-safe
+ -Wno-unsafe
+ -Wno-all-missed-specialisations
-rtsopts
-threaded
-optc-O3
-optc-march=native
-O2
- ghc-prof-options:
- -prof
- -auto-all
- -caf-all
-
test-suite testsuite
type: exitcode-stdio-1.0
main-is: TestSuite.hs
build-depends:
- base >= 4.6 && < 4.8,
- bytestring == 0.10.*,
- cmdargs == 0.10.*,
- dns >= 1.2,
- MissingH == 1.2.*,
- parallel-io == 0.3.*,
- split == 0.2.*,
- tasty == 0.8.*,
- tasty-hunit == 0.8.*,
+ base == 4.*,
+ cmdargs >= 0.10,
+ split >= 0.2,
+ tasty >= 0.8,
+ tasty-hunit >= 0.8,
tasty-quickcheck >= 0.8.1
-- 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
+ -Weverything
+ -Wno-implicit-prelude
+ -Wno-safe
+ -Wno-unsafe
+ -Wno-all-missed-specialisations
-rtsopts
-threaded
-optc-O3
main-is: ShellTests.hs
build-depends:
- base >= 4.6 && < 4.8,
- bytestring == 0.10.*,
- cmdargs == 0.10.*,
- dns >= 1.2,
- MissingH == 1.2.*,
- parallel-io == 0.3.*,
- process < 1.3,
- split == 0.2.*,
- tasty == 0.8.*,
- tasty-hunit == 0.8.*,
- tasty-quickcheck >= 0.8.1
-
- -- 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.8,
- bytestring == 0.10.*,
- cmdargs == 0.10.*,
- dns >= 1.2,
- MissingH == 1.2.*,
- parallel-io == 0.3.*,
- process < 1.3,
- split == 0.2.*,
- tasty == 0.8.*,
- tasty-hunit == 0.8.*,
+ base == 4.*,
+ cmdargs >= 0.10,
+ process >= 1.1,
+ split >= 0.2,
+ tasty >= 0.8,
+ tasty-hunit >= 0.8,
tasty-quickcheck >= 0.8.1
-- It's not entirely clear to me why I have to reproduce all of this.
-optc-march=native
-O2
-
source-repository head
type: git
- location: http://michael.orlitzky.com/git/hath.git
+ location: http://gitweb.michael.orlitzky.com/hath.git
branch: master
projects / hath.git / blobdiff