ip2/README.md

Get ip info & manage the hosts files

[![Build Status](https://api.travis-ci.org/markzhan/ip2.svg)](http://travis-ci.org/markzhan/ip2)
[![NPM Version](http://img.shields.io/npm/v/ip2.svg?style=flat)](https://www.npmjs.org/package/ip2)
[![NPM Downloads](https://img.shields.io/npm/dm/ip2.svg?style=flat)](https://www.npmjs.org/package/ip2)


# ip2

Get ip info & manage the hosts files.

## Installation
```
$ npm i -g ip2
# or
$ sudo npm i -g ip2
```

## Example
```sh
$ ip2 -h        # print help
$ ip2 -lis      # ip & system info
$ ip2 qq.com    # get dns information
$ ip2 8.8.8.8   # get ip geo location

$ ip2 ls        # list hosts
$ ip2 cat       # print hosts content
$ sudo ip2 add google.txt  # add hosts file to system
$ sudo ip2 use google      # use the hosts file

$ ip2 24           # 255.255.255.0
$ ip2 127.0.0.1    # ipv4 to long
$ ip2 2130706433   # long to ipv4
$ ip2 '! 255.255.255.0'  # 0.0.0.255
$ ip2 '192.168.1.134 or 0.0.0.255'  # 192.168.1.255
$ ip2 '192.168.1.134 mask 255.255.255.0'  # 192.168.1.0
$ ip2 '192.168.1.134 subnet 255.255.255.192'  # subnet information
$ ip2 192.168.1.134/26  # CIDR subnet, same as previous
```
NOTICE: The sudo is must be used when you operating the hosts file.

## Usage
```
Usage: ip2 [options] [command]

  Commands:

    ls [dir]       list hosts
    cat [hosts]    print hosts contents
    add <file>     add custom hosts to system
    use <hosts>    change system hosts to custom hosts
    rm <hosts>     delete one custom hosts file
    reload         reload used hosts
    reset          reset hosts
    init           init hosts
    *              ip utilities
    help           help & example

  Options:

    -h, --help      output usage information
    -V, --version   output the version number
    -v, --version   get version number
    -f, --force     overwrite file
    -l, --local     get local ip
    -s, --system    get system info
    -i, --internet  get internet ip info
    -c, --chinese   output geo ip in chinese
```
See [MANUAL](https://github.com/markzhan/ip2/blob/master/doc/MANUAL.md) for details.

## Hosts file

* [alsohosts](https://github.com/alsotang/alsohosts)
* [smarthosts](https://code.google.com/p/smarthosts/)
* [google hosts](http://code.google.com/p/googlehosts/)
* [google-hosts](https://github.com/txthinking/google-hosts)
* [williamlong](http://www.williamlong.info/archives/3983.html)

## Release History
See the [CHANGELOG](https://github.com/markzhan/ip2/blob/master/doc/CHANGELOG.md).

## License

Copyright (c) 2015 [Mark Zhan](http://markzhan.com).

This project is available under the MIT license. See [LICENSE](https://github.com/markzhan/ip2/blob/master/LICENSE) for details.