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