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/02/2012                                     GRML-BTNETS(8)