summaryrefslogtreecommitdiff
path: root/wpa-psk-cli/README.md
blob: f450d6c08905cc544733d6c1e5447d4a677947f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# wpa-psk-cli

This is a command-line utility to compute the WPA pre-shared key of a Wi-Fi
SSID and passphrase. See also the corresponding Rust library `wpa-psk`.

This project's original source code is hosted [here][home].

[home]: https://git.skreutz.com/wpa-psk.git/

## Usage

Hash a typical SSID and passphrase:

    $ wpa-psk home password123
    0xde811641af2c516ffd35cc6f851b3abf03c7c84fc703cfb580f1c0456943cdc0
    
Hash *special* albeit valid credentials:

    $ wpa-psk "123abcABC.,-" "456defDEF *<:D"
    0x8a366e5bc51cd5d8fbbeffacc5f1af23fac30e3ac93cdcc368fafbbf63a1085c
    
Hash *invalid* credentials:

    $ wpa-psk --force bar 2short
    0xcb5de4e4d23b2ab0bf5b9ba0fe8132c1e2af3bb52298ec801af8ad520cea3437

## Installation

You can install the `wpa-psk` utility using Cargo:

    $ cargo install wpa-psk-cli

## License

This work is distributed under the terms of both, the [MIT License][MIT] and
the [Apache License, Version 2.0][Apache-2.0].

[MIT]: LICENSE-MIT
[Apache-2.0]: LICENSE-APACHE-2.0

## Contribution

Contributions are welcome! Please [contact][] me via email.

[contact]: https://www.skreutz.com/contact/

## See also

The popular [wpa_supplicant][] comes with a similar tool, `wpa_passphrase(8)`.

[wpa_supplicant]: https://hostap.epitest.fi/wpa_supplicant/
Generated by cgit. See skreutz.com for my tech blog and contact information.