Skip to content

Commit

Permalink
Merge pull request #18 Add debian rule for wpa_supplicant
Browse files Browse the repository at this point in the history
Add debian rule for wpa_supplicant
  • Loading branch information
Pterosaur authored Nov 24, 2020
2 parents 0577e8e + ffba528 commit 5c672b7
Show file tree
Hide file tree
Showing 83 changed files with 9,858 additions and 0 deletions.
39 changes: 39 additions & 0 deletions debian/NEWS
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
wpasupplicant (2:2.6-19) unstable; urgency=medium

With this release, wpasupplicant no longer respects the system
default minimum TLS version, defaulting to TLSv1.0, not TLSv1.2. If
you're sure you will never connect to EAP networks requiring anything less
than 1.2, add this to your wpasupplicant configuration:

tls_disable_tlsv1_0=1
tls_disable_tlsv1_1=1

wpasupplicant also defaults to a security level 1, instead of the system
default 2. Should you need to change that, change this setting in your
wpasupplicant configuration:

openssl_ciphers=DEFAULT@SECLEVEL=2

Unlike wpasupplicant, hostapd still respects system defaults.

-- Andrej Shadura <andrewsh@debian.org> Sat, 15 Dec 2018 14:22:18 +0100

wpasupplicant (0.6.2-1) unstable; urgency=low

The -w (wait for network interface to exist) command line option no longer
exists. If you have scripts that require this option, it is time to change
them, or use one of the two supported modes of operation explained at
/usr/share/doc/wpasupplicant/README.modes.gz.

ifupdown supports hot-plugged network devices via the "allow-hotplug" class
of operation. An example /etc/network/interfaces configuration stanza would
look like:

allow-hotplug wlan0
iface wlan0 inet dhcp
wpa-ssid myssid
wpa-psk mysecretpassphrase

network-manager is also able to handle hot-plugged network devices.

-- Kel Modderman <kel@otaku42.de> Mon, 14 Jan 2008 18:02:17 +1000
9 changes: 9 additions & 0 deletions debian/NetworkManager/no-mac-addr-change.conf
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Certain drivers are known not to support changing the MAC address.
# Disable touching the MAC address on such devices.
#
# See man NetworkManager.conf
#
# https://bugzilla.gnome.org/show_bug.cgi?id=777523
[device-31-mac-addr-change]
match-device=driver:eagle_sdio,driver:wl
wifi.scan-rand-mac-address=no
130 changes: 130 additions & 0 deletions debian/README.source
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
"wpa" sources for Debian
------------------------

**WARNING**: THIS IS OUTDATED; check debian/watch for the actual URLs.

This "wpa" source package merges wpa_supplicant and hostapd sources, which are
maintained in one source repository[1] upstream and share considerable/
duplicate amounts of source. Starting with the 1.x branch, both wpa_supplicant
and hostapd are built from this common source package for Debian, while not
released together as tarball by upstream, the source can be obtained from the
upstream git repositories.

The preferred way to generate the orig.tar.gz is by calling

$ debian/rules get-orig-source

which will clone the upstream git repository under $TMPDIR, using mktemp(1),
and create a new tarball based on the git tag corresponding to the top most
entry in debian/changelog. This newly generated tarball will be stored as
../wpa_${VERSION}.orig.tar.gz or ../tarballs/wpa_${VERSION}.orig.tar.gz, if
a directory called ../tarballs/ exists. Eventually existing tarballs
corresponding to the current version will not be overwritten.

Required dependencies to generate a new orig.tar.gz:
- a SUSv3 compatible shell, like dash or bash
- dpkg-parsechangelog, available from dpkg-dev
- git
- xz, available from xz-utils or busybox
- mktemp and rm, available from coreutils or busybox
- sed, available from sed or busybox
- tar, available from tar or busybox

It is recommended to base tarballs for development snapshots of "wpa" on
according git tags from the upstream git repository, the available git tags
can be queried by:

$ git clone git://w1.fi/srv/git/hostap-1.git # 1.x branch

or

$ git clone git://w1.fi/srv/git/hostap.git # >= 2.x branches

changing into the corresponding directory (hostap-1 or hostapd) and calling
git tag.

$ cd hostapd-1
$ git tag
hostap_0_6_3
[…]
hostap_1_0
[…]
hostap_1_0_rc3
[…]

The Debian versions for these tags would be 0.6.3-1, 1.0 or 1.0~rc3 in
debian/changelog. Intermediate states between tags or HEAD are usually best
dealt with by creating a patch series based on the newest matching tag.

Exporting commits between "hostap_1_0" and the current git HEAD:

$ git format-patch hostap_1_0..HEAD

Exporting commits between "hostap_1_0_rc3" and "hostap_1_0":

$ git format-patch hostap_1_0_rc3..hostap_1_0

In both cases numbered patches will be dropped in the base directory of the
git clone. These numbered patches can be imported to the Debian package using
standard procedures for "3.0 (quilt)" source packages.

Tarballs can also be created manually from the upstream git repository:

$ git clone git://w1.fi/srv/git/hostap-1.git
$ cd hostap-1
$ git archive \
--format=tar \
--prefix="wpa-1.0/" \
hostap_1_0 \
README COPYING patches src wpa_supplicant hostapd | \
xz -c6 > wpa_1.0.orig.tar.gz

Arbitrary git tags or commit IDs can be used for this purpose.


Upstream git snapshots can be exported by using a specially crafted version
syntax used in the top most (pending) changelog entry. The required syntax for
correctly parsing this is:

<upstream_version>+git<date>.<revision>+<git_hash>-<debian_revision>
upstream_version := [0-9\.]* --> 2.0
date := [0-9]* --> 20131120 (YYYYMMDD)
revision := [0-9]* --> 1
git_hash := [0-9a-f]* --> 594516b
debian_revision := [0-9*] --> 1

e.g.:

2.0+git20131120.1+594516b-1

Technically any incrementing number can be used for <date>, but it's strongly
recommended to use YYYYMMDD (date --utc +%Y%m%d) and follow it by an
strictly incrementing arbitrary revision number (typically '.1'). The supplied
git hash can be abbreviated, but must be unique (see git describe, without
leading 'g').

The debian/rules get-orig-source target will automatically switch between
hostapd-1.git and hostapd.git (for >= 2.0) as needed, but it will only fetch
the explicitly specified version from a properly formatted, top most,
debian/changelog entry; it will not fetch the last upstream release or git
HEAD automatically.


The Debian packaging for wpa_supplicant/ hostapd is maintained in a subversion
repository at:

Vcs-Svn: svn://anonscm.debian.org/svn/pkg-wpa/wpa/trunk/
Vcs-Browser: http://anonscm.debian.org/viewvc/pkg-wpa/wpa/trunk/

The development mailing list and its mailing list archive is located at:

http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-wpa-devel

Work for the wpa package can be coordinated on this mailing list through:

Debian wpasupplicant Maintainers <pkg-wpa-devel@lists.alioth.debian.org>

-- Stefan Lippers-Hollmann <s.l-h@gmx.de> Sat, 28 Dec 2013 22:37:03 +0100

[1] http://hostap.epitest.fi/gitweb/gitweb.cgi?p=hostap-1.git [1.x branch]
http://hostap.epitest.fi/gitweb/gitweb.cgi?p=hostap.git [development]
Loading

0 comments on commit 5c672b7

Please sign in to comment.