wpscp(1) wpscp manual wpscp(1) NAME wpscp - adds a new wireless profile to the list of preferred WLANs SYNOPSIS wpscp -n -s -c IBSS|ESS -a Open|Shared|WPA|WPAPSK|WPA-NONE|WPA2|WPA2PSK -e None|WEP|TKIP|AES [-k ] [-i ] [-p] [-x] [-m EAP-TLS|PEAP] DESCRIPTION wpscp allows you to create a new entry in the list of preferred networks of a wireless network interface card. It uses the "Wireless Provisioning Service" API (WPS) which is available on Windows XP SP2 only. Furthermore this means, that you have to keep the "Wireless Zero Configuration Service" (WZC) running, while using wpscp. The two last characters "cp" in the name stand for "CreateProfile", which is the name of a COM interface method of WPS. The arguments you provide when calling wpscp are put together with XML tags forming an XML data stream, which is dumped to the console before feeding it to CreateProfile. You always have to provide the first five options. The others aren't needed in every case - it depends. wpscp doesn't check, if all needed arguments are there - at least not for all cases. Instead it provides you with the (text) error messages of WPS/WZC, if something is wrong. OPTIONS -n Specifies the name of the wireless NIC which will get a new entry in it's preferred list of networks. -s SSID for the new entry, 1 to 32 characters allowed -c IBSS | ESS Connection type; "IBSS" = Ad-Hoc, "ESS" = Infrastructure -a Open | Shared | WPA | WPAPSK | WPA-NONE | WPA2 | WPA2PSK Authentication type -e None | WEP | TKIP | AES Encryption type -k Network key. 5 to 64 characters allowed. The format depends on whether it is a WEP key or a WPA-PSK and if your are using a "password" or a "hex key". Of course this option doesn't make sense if you aren't using any type of authentication/encryption. NOTE: I haven't managed to enter a "hex key", I don't know what's wrong. "password" seemed to work. Currently I don't use this option - so I've got very little experience with it. -i Index of the key. Numbers 1 to 4 allowed and only if option -k is present and you are using WEP. For WPA there is no such thing like a "key index". NOTE: Again, I don't use this option, too - little experience. -p Key provided automatically. Enables the checkbox on the properties page of a wireless network entry, which says that the (network) key will be "provided automatically". If you want to use IEEE 802.1X, you will have to use this option -x IEEE 802.1X enabled. Enables the checkbox on the properties page of a wireless network entry, which decides if IEEE 802.1X should be enabled or not. -m EAP-TLS | PEAP If you want to use IEEE 802.1X, you'll have to use option -x and you'll have to specify which EAP method you want to use. EXAMPLES wpscp -n "Dell TrueMobile 1150 Series Wireless LAN Mini PCI Card" -s TESTADHOC -c IBSS -a Open -e None Adds a new entry to the list of preferred networks of the wireless NIC with the name "Dell TrueMobile 1150 Series Wireless LAN Mini PCI Card". The new entry will use the SSID "TESTADHOC", using Ad-Hoc mode ("IBSS"), no or "Open" authentication and no encryption. wpscp -n "Dell TrueMobile 1150 Series Wireless LAN Mini PCI Card" -s WNET -c ESS -a Open -e WEP -p -x -m EAP-TLS Adds an entry with SSID "WNET", type Infrastructure ("ESS"), no or "Open" authentication and "WEP" for encryption. Furthermore it enables IEEE 802.1X (-x) and says that the (network) key will be provided automatically (-p). "EAP-TLS" is chosen for IEEE 802.1X's EAP method. NOTES This program hasn't been tested on many setups! And it hasn't been tested if it is able to create all kinds of known types and combinations of wireless network entries! I basically wrote it to do exact the same thing what the second example (see EXAMPLES) does. So there almost certainly might be issues with creating entries for plain WEP or any of the WPA types. If you experience any errors, just send me an email with the output of wpscp and if there is time I'll have a look into it. For more information on the "Wireless Provisioning Service", go to Microsoft's homepage and search for "WPS DDK". It's a very small part of the DDK. wpscp works on Windows XP SP2 only! BUGS Well, this is a very "quick and dirty" tool - so there might be tons of bugs ... ;-) AUTHOR Written by Joachim Förster . COPYRIGHT Copyright (C) 2006 Joachim Förster This program is free software; see the source for copying conditions. There is NO warrenty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. wpscp(1) $LastChangedDate: 2006-09-13 14:43:18 +0200 (Mi, 13 Sep 2006) $