GRML-BTNETS(8)
=============
Michael Gebetsroither <michael.geb@gmx.at>

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>.

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