create_ap

create a nat-ed wifi ap
git clone git://git.2f30.org/create_ap
Log | Files | Refs | README | LICENSE

commit 8bee5d61ba4d75ea1e74ed1b0246554b90beb3eb
parent b39f4466de4680606cf8d6a040eb07ae42b9f0f5
Author: oblique <psyberbits@gmail.com>
Date:   Wed,  4 Dec 2013 15:39:01 +0200

Update README file

Diffstat:
MREADME.md | 66+++++++++++++++++++++++++++++++++++++++++++++---------------------
1 file changed, 45 insertions(+), 21 deletions(-)

diff --git a/README.md b/README.md @@ -1,46 +1,69 @@ -## Dependencies +## Features +* Create an AP (Access Point) at any channel. +* Choose one of the following encryptions: WPA, WPA2, WPA/WPA2, Open (no encryption). +* Hide your SSID. +* Internet sharing methods: NATed or Bridged or None (no Internet sharing). +* Choose the AP Gateway IP (only for 'NATed' and 'None' Internet sharing methods). +* You can create an AP with the same interface you are getting your Internet connection. +* You can pass your SSID and password through pipe or through arguments (see examples). + +## Dependencies +### General * bash (to run this script) * util-linux (for getopt) * hostapd -* dnsmasq -* iptables * iproute2 +* iw * haveged (optional) -## Examples +### For 'nat' or 'none' Internet sharing method +* dnsmasq +* iptables -### No passphrase (open network): +### For 'brigde' Internet sharing method +* bridge-utils +* dhclient - ./create_ap wlan0 eth0 MyAccessPoint -OR +## Installation +### + git clone https://github.com/oblique/create_ap + cd create_ap + make install - echo -e "MyAccessPoint" | ./create_ap wlan0 eth0 + +## Examples +### No passphrase (open network): + create_ap wlan0 eth0 MyAccessPoint ### WPA + WPA2 passphrase: + create_ap wlan0 eth0 MyAccessPoint MyPassPhrase - ./create_ap wlan0 eth0 MyAccessPoint MyPassPhrase +### AP without Internet sharing: + create_ap -n wlan0 MyAccessPoint MyPassPhrase -OR +### Bridged Internet sharing: + create_ap -m bridge wlan0 eth0 MyAccessPoint MyPassPhrase - echo -e "MyAccessPoint\nMyPassPhrase" | ./create_ap wlan0 eth0 +### Internet sharing from the same WiFi interface: + create_ap wlan0 wlan0 MyAccessPoint MyPassPhrase -### AP without Internet sharing: +### No passphrase (open network) using pipe: + echo -e "MyAccessPoint" | create_ap wlan0 eth0 - ./create_ap -n wlan0 MyAccessPoint MyPassPhrase +### WPA + WPA2 passphrase using pipe: + echo -e "MyAccessPoint\nMyPassPhrase" | create_ap wlan0 eth0 -OR - - echo -e "MyAccessPoint\nMyPassPhrase" | ./create_ap -n wlan0 ## Systemd service Using the persistent [systemd](https://wiki.archlinux.org/index.php/systemd#Basic_systemctl_usage) service -### Install: - # cp create_ap.service /etc/systemd/system - ### Start service immediately: - # systemctl start create_ap + systemctl start create_ap ### Start on boot: - # systemctl enable create_ap + systemctl enable create_ap + + +## License +FreeBSD +\ No newline at end of file