NAME

       grml-btnets - program to setup a bluetooth network access point (NAP)

SYNOPSIS

       grml-btnets [OPTIONS] <ACTION>

DESCRIPTION

       grml-btnets is a program that provides an easy wrapper around all the programms to create
       a ready to run network access point for bluetooth and additionally setup internet
       forwarding. If no pin is given for the bluetooth network, a random pin will be choosen.

ACTIONS

       start
           Start the network access point

       stop
           Stop the network access point

       help
           Show the help message.

OPTIONS

       -h, help
           Show summary of options.

       -v
           Show what is going on (more v ⇒ more out).

       -s [subnet] (default=192.168.10.0/24)
           The subnet for the bluetooth clients. There should be at least 8 IPs in this subnet
           (/28).

       -i [interface] (default=eth0)
           Enable IP-Forwarding for this interface, so that the bluetooth-network could, for
           example, connect to the internet. The nameservers come from your /etc/resolv.conf, so
           be aware to configure this before you run grml-btnets. Grml-btnets does not touch the
           ip_forward and iptables config without this option! Do not use this option if you
           already have a working internet gateway on your box. Grml-btnets assumes that the
           chain policy of forward is on accept. If this is not the case please let packages from
           interface grmlbtnet pass.

       -p <pin>
           The bluetooth pin. If no or an empty pin is given, a random one will be choosen and
           printed to stdout.

EXAMPLES

       grml-btnets -p 1234 start
           This creates a simple bluetooth access point (NAP) with default values. The subnet for
           the bluetooth network is 192.168.10.0/24. There will be no masquerading.

       grml-btnets stop
           Stops the NAP created with the command above.

       grml-btnets -s 192.168.1.0 -i ppp0 start
           This creates a NAP and the bluetooth clients get IPs within 192.168.1.0/24. This also
           creates masquerading out of ppp0 to let bluetooth clients onto the internet.

       grml-btnets -i ppp0 stop
           This command stops the NAP created with the commando above.

SEE ALSO

       grml-btnet(8), grml-btnetc(8), pand(1), hcid(8), hcid.conf(5), hciconfig(8), hcidump(1),
       sdpd(8), sdptool(1)

AUTHOR

       grml-btnets was written by Michael Gebetsroither <michael.geb@gmx.at[1]>.

       This manual page was written by Michael Gebetsroither <gebi@grml.org[2]>.

AUTHOR

       Michael Gebetsroither <michael.geb@gmx.at>
           Author.

NOTES

        1. michael.geb@gmx.at
           mailto:michael.geb@gmx.at

        2. gebi@grml.org
           mailto:gebi@grml.org

                                            08/13/2015                             GRML-BTNETS(8)