Skip to content

Commit

Permalink
Merge branch 'master' of github.com:Ajnasz/dnsbl-check
Browse files Browse the repository at this point in the history
  • Loading branch information
Ajnasz committed Jun 18, 2021
2 parents 704a88b + dbdd005 commit 548faa5
Showing 1 changed file with 14 additions and 4 deletions.
18 changes: 14 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@ Providers must be listed in a file, one line should be one provider.
Empty lines are ignored.
Lines started with `#` are ignored.

The file name must be passed with the `-p` parameter to the command.
The file name must be passed with the `-p` parameter to the command or `-` for standard input.

## Addresses

IP addresses or domain names which needs to be tested against the providers.
The addresses must be passed with the `-i` parameter to the command. Multipla address can be listed, separate them by comma (`,`).
The addresses must be passed with the `-i` parameter to the command. Multiple address can be listed, separate them by comma (`,`).

## Build

Expand All @@ -23,10 +23,20 @@ go build

## Execute

Variations for the same operation:

```sh
./dnsbl-check -i 1.2.3.4 -p providers
```

```sh
./dnsbl-check -i 1.2.3.4 -p - < providers
```

```
cat providers | ./dnsbl-check -i 1.2.3.4 -p -
```

## Output

The program returns every result in a new line, fields are separated by TAB character `\t`.
Expand All @@ -37,7 +47,7 @@ The line starts with the status: `OK` or `FAIL` or `ERR`
- `ERR` returned if the address lookup failed
Second field is the address
Third field is the provider
Fourth field is filled only if the statis is either `FAIL` or `ERR`. If the status is `FAIL` and no reason returned from te provider, the `unknown reason` text will be shown. If the status is `ERR` the error message will be shown here.
Fourth field is filled only if the status is either `FAIL` or `ERR`. If the status is `FAIL` and no reason returned from te provider, the `unknown reason` text will be shown. If the status is `ERR` the error message will be shown here.

```
OK 127.0.0.2 dyn.rbl.polspam.pl
Expand Down Expand Up @@ -76,7 +86,7 @@ awk '$5 == "b" && $2 == "ipv4" && $1 != "(hidden)" { print $1 }' < providers | \
./dnsbl-check -p - -i 1.2.3.4
```

However it's recommended to keep the used provider list separetly, to save the resources of the providers.
However it's recommended to keep the used provider list separately, to save the resources of the providers.

### Domain providers:

Expand Down

0 comments on commit 548faa5

Please sign in to comment.