reinit the tree, so we can have metadata

4 files changed, 308 insertions, 0 deletions

diff --git a/net-dialup/ueagle-atm/Manifest b/net-dialup/ueagle-atm/Manifest
new file mode 100644
index 000000000000..0be69d67a3b2
--- /dev/null
+++ b/net-dialup/ueagle-atm/Manifest
@@ -0,0 +1,6 @@
+AUX README 8687 SHA256 af7825923a826b4c65f2c390ae2dd8e282d9c72279323b5428508df1c2fdb402 SHA512 a847cb05b8ab1050257940a717ef32b74b5d92fc280a07b1189274e14e3b0481c6a4ccfb31411350ea7e38360f2f478748ff46fb3214586b9466a6cef7a4a36c WHIRLPOOL 3f2651ee603dcaecdb32df424082156454e75d198a5bdf320ac4a2afe1f8ff39ca4c49fceaae2bd9f43718f4c03af02dbcce2d3070d494245c4a2f1dbe392ce9
+DIST ueagle-data-src-1.1.tar.gz 1270515 SHA256 45b944e5b141591b9a7e64b7e1e704b8507a73f9314dee2f572e4a845f6096c2 SHA512 ce4d54c02da9943d7ee77615142c64c3ec02acea00a3d107dbeaa0dad9f047b5bda5844e8b896596af000bcb9a9fd0f49aa04a9da603760639bd7655933a98fa WHIRLPOOL 0b2d4227f768a2e17e9a0f0aede79ec1cb5f709172f84003dfecdf2473771a6b4207f7007204538c1f707543a748446eee48d50963cda27caef3aee73328f545
+EBUILD ueagle-atm-1.1-r3.ebuild 1727 SHA256 f5b2a331c7c771f588e0854e77c1bbe1e4b07c761fc54504ffade373635d95a2 SHA512 da1e520d8245f9a407ee8b14b6617808c8c00215cc676d6277889f7c7b3685fff6962ea531a7a0d78eb469e462b68a1052174fa78650d518144c87917f4e50ef WHIRLPOOL 041171de2f5f3fd3a85fd5fbc479bfd1bccb9c0b205df51c54eef58b27545ca1b7a4d4aa025dd8d327d5b214fdda12d99f00be7c1e9ccd5e6ecddc4814ec7c5f
+MISC ChangeLog 2877 SHA256 674e3cbc9c90c20327326d9151adfb71ea3100d66af387cc56f7f758fe91ad6c SHA512 255e57096ff185d6e4b13485a9411c45490afa98b3269ca083947e289f54b53d9d8c5a107bde6934eef0ce99a777511843f3e5ce12b4c17b65c4fa2941a04647 WHIRLPOOL 6f6ec1551cda7285b49c97cbd51817b1983881595979a1649b15b68df61196fb75649154ec36de3e2e79b88fa35b4f3713053d9305a9338578d18c9808bae0d0
+MISC ChangeLog-2015 1877 SHA256 742fd9fb364ea62cfdd0b1872398ea477296381a09d266529aa675f388ae8fdb SHA512 74a9fc065a31fc53bdbfd178c0b83955572235502b9588d6d172fa5e2f0f06cefe35ad33491a4a53b8492a9d9006c82e04d34a8b8f5dbe9c6ad780fd309c76e6 WHIRLPOOL dd0d38df0beff179fc9d83ce2ef2da8f8e49985e5c9cf1773d5a4fa49a506636c944086986431a95c598e15897bc7181467cf0b9e36dc52f687de5b1314e847c
+MISC metadata.xml 318 SHA256 93ba08bceca5af252ac69a75ce40f1349e2900f6f8aa81562dbb3cb900abd547 SHA512 cb837defad14a199f7c0ad62a721e08afee90ee05125b8783cd7cf7059f9c7090e3fd18c2cf3d91e6dde78b7cf86a3abd70a3d4e22f9b4a59bee750bda214ced WHIRLPOOL 8aca85048b8c5f94a06001f685ba35b8a536da39fa59def35faecf76a5653908d30230b3ff34133ab91b5f43459eaa54fe1fa3173df083733da0b00949b45713
diff --git a/net-dialup/ueagle-atm/files/README b/net-dialup/ueagle-atm/files/README
new file mode 100644
index 000000000000..ef07b71dadcd
--- /dev/null
+++ b/net-dialup/ueagle-atm/files/README
@@ -0,0 +1,235 @@
+Introduction
+============
+
+This ebuild installs firmware files necessary for ADI 930/Eagle USB ADSL 
+Modem driver which first appeared in kernel 2.6.16.
+
+Configuration
+=============
+
+Most ADSL modems are connected via the ATM protocol, rather
+than Ethernet. For ATM, run the following:
+   euse -E atm && emerge net-dialup/ppp net-dialup/ueagle-atm
+
+It is necessary to choose an interface number for the connection. This
+is arbitrary - the only requirement is that the connection number is
+not already in use. The first available number is 0, and it is usual to
+choose the lowest unused number. For the purposes of this document, 0
+will be chosen.
+
+Add the following lines from the appropriate section below to
+/etc/conf.d/net, then customize them as per the inline comments.
+
+
+a) PPPoATM configuration:
+
+config_ppp0='ppp'  # Runs /lib/rcscripts/net/pppd.sh
+# The 2 numbers represent the VPI & VCI of your ISP, and they are separated
+# by a dot. Ask your ISP about those numbers.
+link_ppp0='0.38'
+plugins_ppp0='pppoa' 
+# 'man pppd' shows other options. Compression is disabled because it is
+# rarely taken advantage of, and may interfere with the connection.
+# Add option 'usepeerdns' to populate /etc/resolv.conf
+pppd_ppp0='updetach noauth debug defaultroute noaccomp nobsdcomp noccp
+	nodeflate nopcomp novj novjccomp child-timeout 60'
+username_ppp0='username@isp.com'  # ADSL login, assigned by your ISP
+password_ppp0='password'  # ADSL password, assigned by your ISP
+
+# If the kernel modules are not built-in, then they must be loaded
+# before starting the PPP daemon:
+function preup() {
+	if [[ "$1" = "ppp0" ]] ; then
+		modprobe -q ueagle-atm
+		return 0
+	fi
+}
+
+
+b) PPPoE configuration:
+
+# Configure first the RFC2684 bridge interface 
+config_nas0='null'
+# Use "-e 0" for LLC mux or "-e 1" for VC mux.
+# The 2 numbers after "-a" represent the VPI & VCI of your ISP, and
+# they are separated by a dot. Ask your ISP about those numbers.
+br2684ctl_nas0='-e 0 -a 0.38'
+
+config_ppp0='ppp'  # Runs /lib/rcscripts/net/pppd.sh
+link_ppp0='nas0' # The name of the RFC2684 bridge interface
+plugins_ppp0='pppoe'
+# 'man pppd' shows other options. Compression is disabled because it is
+# rarely taken advantage of, and may interfere with the connection.
+# Add option 'usepeerdns' to populate /etc/resolv.conf
+pppd_ppp0='updetach noauth debug defaultroute noaccomp nobsdcomp noccp
+	nodeflate nopcomp novj novjccomp child-timeout 60'
+username_ppp0='username@isp.com'  # ADSL login, assigned by your ISP
+password_ppp0='password'  # ADSL password, assigned by your ISP
+
+depend_ppp0() {
+    need net.nas0
+}
+
+# If the kernel modules are not built-in, then they must be loaded
+# before starting the RFC2684 bridge:
+function preup() {
+	if [[ "$1" = "nas0" ]] ; then
+		modprobe -q ueagle-atm
+		return 0
+	fi
+}
+
+
+Configuration continued
+=======================
+
+Create a symlink for the new network interface, for it to be enabled by
+baselayout:
+  cd /etc/init.d && ln -sfn net.lo net.ppp0
+If you use PPPoE, you should also create the symlink for the RFC2684
+bridge interface:
+  cd /etc/init.d && ln -sfn net.lo net.nas0
+
+The "debug" option adds some extra commentary from pppd regarding the
+connection to /var/log/messages, e.g.:
+"sent [LCP ConfReq id=0x1 <magic 0x7bea6ef1>]". It is wise to keep the
+option on permanently, due to its usefulness when debugging.
+
+Set RC_NET_STRICT_CHECKING="yes" in /etc/conf.d/rc, to prevent Internet
+services in /etc/init.d/ from starting before the Internet connection
+is established. Other options are to start/stop programs in
+/etc/ppp/ip-{up,down}.local, and to customize initscript dependencies
+as described in:
+  http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=4
+
+
+Starting the Connection
+=======================
+
+To start manually, with the modem connected:
+  /etc/init.d/net.ppp0 start
+
+To start automatically when the PC boots:
+  rc-update add net.ppp0 default
+
+
+Kernel Configuration
+====================
+
+The ebuild, during an emerge, checks that the required kernel modules
+are present.
+
+Note that in the list below, "[*]" means that the option is compiled
+into the kernel, whereas "[M]" means that the option can either be
+compiled into the kernel, or as a module. Compiling them into the
+kernel is recommended, to guarantee that the modules are already loaded
+when they are needed, and it will improve the bootup time by a couple
+of seconds.
+
+In "make menuconfig", you can press "/" and search on e.g. "eagle"
+to see exactly where an option is - the location of an option and its
+dependencies can change between kernel versions.
+
+Check that the following kernel options are configured as shown (this
+list includes the prerequisites, e.g. USB_UEAGLEATM depends on USB):
+
+ Code maturity level options  --->
+  [*] Prompt for development and/or incomplete code/drivers
+        - CONFIG_EXPERIMENTAL
+
+ Device Drivers  --->
+  Generic Driver Options  --->
+   [ ] Select only drivers that don't need compile-time external
+        firmware (*unselected*) - CONFIG_STANDALONE
+   [*] Hotplug firmware loading support - CONFIG_FW_LOADER
+
+ Networking  --->
+   [*] Networking support - CONFIG_NET
+   Networking options  --->
+    [*] Packet socket - CONFIG_PACKET
+    [M] Asynchronous Transfer Mode (ATM) - CONFIG_ATM
+    [M] RFC1483/2684 Bridged protocols - CONFIG_ATM_BR2684 (only needed for PPPoE)
+   
+ Device Drivers  --->
+  Network device support  --->
+   [*] Network device support - CONFIG_NETDEVICES
+   [*] PPP (point-to-point protocol) support - CONFIG_PPP
+   [M] PPP Deflate compression - CONFIG_PPP_DEFLATE (only useful if
+        compression is supported - rare)
+   [M] PPP BSD-Compress compression - CONFIG_PPP_BSDCOMP (only useful
+        if compression is supported - rare)
+   [M] PPP over Ethernet - CONFIG_PPPOE (only needed for PPPoE)
+   [M] PPP over ATM - CONFIG_PPPOATM (only needed for PPPoATM)
+  USB support  --->
+   [*] Support for Host-side USB - CONFIG_USB
+   [*] USB device filesystem - CONFIG_USB_DEVICEFS
+   [M] (O or U)HCI HCD support
+   USB DSL modem support  ---> 
+    [M] USB DSL modem support - CONFIG_USB_ATM
+    [M] ADI 930 and eagle USB DSL modem - CONFIG_USB_UEAGLEATM
+
+
+
+Troubleshooting
+===============
+
+Try "emerge ueagle-atm" again, because the ebuild checks that the
+required kernel modules are present (showing a warning message if
+appropriate), and creates the firmware files in /lib/firmware/ueagle-atm.
+
+If the modem is unresponsive, then run "/etc/init.d/net.ppp0 stop" and
+unplug the modem for 30 seconds, to drain its memory. Then reconnect
+the modem to the PC and run "/etc/init.d/net.ppp0 start"
+
+To check the modem's connection progress, run:
+  tail -f /var/log/messages
+/var/log/messages should show e.g.:
+
+pppd[nnn]: Plugin pppoatm.so loaded.
+pppd[nnn]: pppd n.n.n started by root, uid 0
+pppd[nnn]: Using interface ppp0
+pppd[nnn]: Connect: ppp0 <--> n.nn
+ADSL line is synchronising
+DSL line goes up
+ADSL line is up (nnn Kib/s down | nnn Kib/s up)
+pppd[nnn]: CHAP authentication succeeded
+pppd[nnn]: local  IP address nnn.nnn.nnn.nnn
+pppd[nnn]: remote IP address nnn.nnn.nnn.nnn
+
+
+If the authentification fails, then check username_ppp0 and
+password_ppp0.
+
+If the ADSL connection is not established, then check the options in
+pppd_ppp0. "man pppd" explains all the options in that file.
+
+If the ADSL connection seems to have worked, but no websites can be
+contacted, then check that /etc/resolv.conf is populated, and possibly
+add the "usepeerdns" option (to use the ISP's DNS) to pppd_ppp0 in
+/etc/conf.d/net .
+
+If the problem is still not resolved, post to the Gentoo Forums at 
+http://forums.gentoo.org/ and ultimately, if there is no answer, 
+file a bug at http://bugs.gentoo.org/ .
+
+
+Compression
+===========
+
+Some ISPs require compression to be disabled in order for the
+connection to work, so the default configuration described above
+disables compression. Few ISPs support ADSL compression anyway. If you
+are lucky enough to have an ISP which *does* support compression
+(Google is your best friend for determining this), then compression can
+be enabled by following these steps:
+
+* Compile the kernel modules CONFIG_PPP_DEFLATE and CONFIG_PPP_BSDCOMP
+(only one is strictly necessary - pppd prefers "deflate" compression).
+Add them to /etc/modules.autoload.d/kernel-2.6 or /etc/conf.d/net above
+the "pppoatm" line, if they are not built-in.
+* Remove the following options in pppd_ppp0:
+  noaccomp nobsdcomp noccp nodeflate nopcomp novj novjccomp
+* Ensure that "debug" is in the pppd_ppp0 options, to check that
+compression is being utilized. Note that "module registered" in
+/var/log/messages only confirms that the kernel module is loaded - 
+it does not indicate that the connection is compressed.
diff --git a/net-dialup/ueagle-atm/metadata.xml b/net-dialup/ueagle-atm/metadata.xml
new file mode 100644
index 000000000000..92efb62d35fd
--- /dev/null
+++ b/net-dialup/ueagle-atm/metadata.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+	<!-- maintainer-needed -->
+	<longdescription>Firmware and configuration instructions for ADI 930/Eagle USB ADSL Modem driver
+available in kernels &gt;= 2.6.16.</longdescription>
+</pkgmetadata>
diff --git a/net-dialup/ueagle-atm/ueagle-atm-1.1-r3.ebuild b/net-dialup/ueagle-atm/ueagle-atm-1.1-r3.ebuild
new file mode 100644
index 000000000000..6143b28417a5
--- /dev/null
+++ b/net-dialup/ueagle-atm/ueagle-atm-1.1-r3.ebuild
@@ -0,0 +1,60 @@
+# Copyright 1999-2017 Gentoo Foundation
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=6
+
+inherit eutils linux-info
+
+DESCRIPTION="Firmware and configuration instructions for ADI 930/Eagle USB ADSL Modem driver"
+HOMEPAGE="https://gna.org/projects/ueagleatm/"
+SRC_URI="http://eagle-usb.org/ueagle-atm/non-free/ueagle-data-src-${PV}.tar.gz"
+
+LICENSE="BSD GPL-2"
+SLOT="0"
+KEYWORDS="~amd64 x86"
+
+DEPEND=""
+RDEPEND="net-dialup/ppp
+	!sys-kernel/linux-firmware"
+
+S="${WORKDIR}/ueagle-data-src-${PV}"
+
+src_compile() {
+	emake generate
+}
+
+src_install() {
+	# Copy to the firmware directory
+	insinto /lib/firmware/ueagle-atm
+	doins build/*
+
+	# Documentation necessary to complete the setup
+	dodoc "${FILESDIR}/README"
+}
+
+pkg_postinst() {
+	# Check kernel configuration
+	local CONFIG_CHECK="~FW_LOADER ~NET ~PACKET ~ATM ~NETDEVICES ~USB_DEVICEFS ~USB_ATM ~USB_UEAGLEATM \
+		~PPP ~PPPOATM ~PPPOE ~ATM_BR2684"
+	local WARNING_PPPOATM="CONFIG_PPPOATM:\t is not set (required for PPPoA links)"
+	local WARNING_PPPOE="CONFIG_PPPOE:\t is not set (required for PPPoE links)"
+	local WARNING_ATM_BR2684="CONFIG_ATM_BR2684:\t is not set (required for PPPoE links)"
+	check_extra_config
+	echo
+
+	# Check user-space for PPPoA support
+	if ! has_version net-dialup/ppp[atm] ; then
+		ewarn "Run the following command if connecting via PPPoA protocol:"
+		ewarn "   euse -E atm && emerge net-dialup/ppp"
+		echo
+	fi
+	# Check user-space for PPPoE support
+	if ! has_version net-dialup/linux-atm ; then
+		ewarn "Run the following command if connecting via PPPoE protocol:"
+		ewarn "   emerge net-dialup/linux-atm"
+		echo
+	fi
+
+	ewarn "To complete the installation, you must read the documentation in"
+	ewarn "   ${ROOT}usr/share/doc/${PF}"
+}