Package Overview
The Devicescape Wireless Infrastructure Platform provides a set of source and binary packages you can use to create state-of-the art, ieee802.11 based wireless access point (AP) firmware. Binary packages are provided both as RPMs (Red Hat Package Manager packages) and iPKGs (Itsy Package Management System packages). The packages system gives you a modular way of working with features and functionality to be provided on the target device.
The following sections describe the various types of packages provided with the Devicescape Wireless Infrastructure Platform, and how to get more information about them.
Understanding Packages
The Devicescape Wireless Infrastructure Platform provides a package set that includes source and binary packages for both the development host and the target AP, along with development support packages. The following sections describe these various types of packages.
Binary Packages for Host and Target
Binary packages are provided for both systems:
- Development Host packages required for use with the platform tools used to create or edit source packages and build the binary images for the target.
- Target binary packages for what will be a working access point (AP) once you have configured the device and loaded the target images (root filesystem and kernel).
Target binary packages are provided both as RPMs and as IPKGs. IPKGs are binary packages created with the Itsy(*) Package Management System. IPKGs can be added, updated or removed on a running system, thereby supporting firmware updates on a deployed network. The IPKG system is also provided as one of the packages on the platform. (For more information, see ipkg package.)
This Package Reference Guide focuses primarily on the details of working with target packages. This guide presents a Quick View of Packages (including licensing information for open source packages) and detailed information on Devicescape specialized packages.
Source for Target Packages
The platform also provides sources (SRPMs) for target packages. You can modify SRPMs and rebuild them as binary RPMs to customize the feature set of the AP. (You can also add new features provided in your own custom packages or open source packages, build these using the platform tools on the development host, and redeploy the target images on the AP.)
Development Support Packages
Also included with the platform are various development ("devel") packages used on the host and target to support related packages.
Core and Contributed Packages
Packages are provided in directories labeled "core" and "contributed". Core packages are those fully supported as a part of the Devicescape Wireless Infrastructure Platform. Contributed packages are those which are available from other sources in the same form but are provided as a convenience. Contributed packages are not supported through Devicescape.
Where to Find Packages on the Development Host
When you install the Devicescape Wireless Infrastructure Platform for your board architecture, the packages are installed on the host in the following high-level directory (beneath which are subdirectories for the different types of packages):
/opt/devicescape/linux/2.0/<Architecture>-bbdyn-uclibc/packages/
Some are specifically host packages and will be used only on that machine, but many are simply made available on the development host so that you can work with them, package them up into an RFS-Kernel image and load onto the target device.
How to Get More Information on a Package
On the Development Host with Devicescape Wireless Infrastructure Platform installed, run the following command to get more information on a binary package (including details on the source package from which particular binary package(s) were generated, license information, and a summary description):
rpm -qilp <PackagePathName>
For example, running rpm -qilp on the ntpclient package gives you the following output:
[vicky@vicky-linux vicky]$ rpm -qilp /opt/devicescape/linux/2.0/ \
armv5bf-bbdyn-uclibc/packages/core/RPMS/ntpclient-2003.194-1.armv5bf-uclibc.rpm
Name : ntpclient Relocations: (not relocatable)
Version : 2003.194 Vendor: TimeSys Corp.
Release : 1 Build Date: Wed 15 Feb 2006 03:59:22 PM PST
Install Date: (not installed) Build Host: bslave01
Group : System Environment/Daemons Source RPM: ntpclient-2003.194-1.src.rpm
Size : 28296 License: GPL
Signature : (none)
URL : http://doolittle.faludi.com/ntpclient/
Summary : A limited functionality NTP client for unix-alike computers
Description :
The Network Time Protocol (NTP) is used to synchronize a computer's time with another reference time source. The ntpclient package contains utilities and daemons that will synchronize your computer's time to Coordinated Universal Time (UTC) via the NTP protocol and NTP servers.
/usr/sbin
/usr/sbin/ntpclient
/usr/share/doc/ntpclient-2003.194
/usr/share/doc/ntpclient-2003.194/HOWTO
/usr/share/doc/ntpclient-2003.194/README
/usr/share/doc/ntpclient-2003.194/log2date.pl
/usr/share/doc/ntpclient-2003.194/rate.awk
/usr/share/man
/usr/share/man/man1
[vicky@vicky-linux vicky]$
For some packages, there is a one-to-one correspondence in that compiling the source package results in a binary package of the same name. For other packages, compiling a source package results in multiple packages (for example, compiling the web-ui-ap-admin package produces both web-ui-ap-admin and web-ui-ap-admin-help binary packages.
How to Get a List of Installed Packages for a Running Target AP
Packages are installed on a target AP by loading a root file system (RFS) image (such as a rootfs.jffs2 file) to that target, as described in the various "Board Guides". You can upload pre-built boot images with standard functionality for a Reference AP, or you can create your own RFS image as described in the Developer Guide topic on "Creating Root File System (RFS) Image for the Reference AP" (Web Docs link is http://www.devicescape.com/docs/wip/developer_guide/rfs.php.)
The packages (and, therefore, functionality) available on the target AP will depend on which packages were bundled into the RFS image, and on those that were since uploaded during runtime using the IPKG system.
To a get a list of the packages available on a running AP, log on to the command line interface (CLI) for the target AP, and type the following command:
(For information on how to log on to the CLI for an AP, see the CLI topic in the Administrator Guide. If you are online, you can get to this topic in the Web Docs at http://www.devicescape.com/docs/wip/admin_guide/App_CLI.php.)
The output of this command shows all packages currently on the target.
Devicescape-AP# ipkg list
device-mgmt-agent - 0.5-2 -
device-mgmt-agent-ap - 0.5-2 -
Quick View of Packages
This section presents a summary of all packages included with the Devicescape Wireless Infrastructure Platform. Information is included on licensing requirements with regard to open source packages. Devicescape packages and open source packages for which there is Devicescape specific information are shown in bold and cross-referenced to topics where you can find more information about them.
Unless otherwise noted, packages listed are target binary packages that can be incorporated into the root file system/kernel as is (or re-built from its source package).
The list below shows all binary target packages provided with the platform. If you would like to see the list of packages needed to create an RFS image for an Enterprise or Reduced Footprint Reference AP, see the Access Point Package List in the Developer Guide topic on Creating RFS Images for the Reference AP. If you are online, you can get to this topic in the Web Docs at: http://www.devicescape.com/docs/wip/developer_guide/rfs.php#ref-ap-list.
.
|
Note
|
Keep in mind that there are development host packages for many of the target packages of the same name (for example, the development package for "hostapd" is "hostapd-devel".) If you rebuild a target package from source on the development host, libraries from the associated "devel" package(s) will be linked in as a part of the build. However, not all target packages have "devel" packages and not all "devel" packages are listed here; only those that are differently named and, therefore, might not be apparent from a list that included only target packages. In general, you need not do anything with "devel" packages; they are provided as a part of the platform installation to support builds of target packages and other host platform functionality.
|
|
Package
|
Description
|
License
|
|
|
Devicescape proprietary Atheros driver used by the IEEE80211 package
|
|
|
basesystem
|
N/A
|
|
|
bash
|
Bourne again shell (common sh replacement)
|
|
|
beecrypt
|
Cryptography toolkit
|
|
|
bridge-utils
|
Linux bridging utilities
|
|
|
|
BusyBox multicall binary that provides UNIX environment
|
|
|
bzip2
|
bzip2 binary
|
|
|
bzip2-libs
|
bzip2 libs
|
|
|
|
Web templating library
|
|
|
|
Command Line Interface (CLI) commands
|
Devicescape Software, Inc.
|
|
|
Clustering, user management, channel planning, sessions, and neighboring AP feature pack.
Note: This replaces the "clustering" package that was distributed in previous versions of this development platform product. To implement clustering, create a new RFS image with the new clustering package in it (instead of the original clustering package), along with the las and libstdc++ packages.
See also web-ui-clustering and las packages.
|
Devicescape Software, Inc.
|
|
|
Device management agent
|
Devicescape Software, Inc.
|
|
device-mgmt-agent-lsql-http
|
A CGI program that allows LSQL queries to be performed over HTTP.
|
Devicescape Software, Inc.
|
|
device-mgmt-agent-ntp
|
Plugins for DMAN to start and configure NTP.
|
Devicescape Software, Inc.
|
|
device-mgmt-agent-ssh
|
A plugin for DMAN to start and configure SSH.
|
Devicescape Software, Inc.
|
|
device-mgmt-agent-web-server
|
A plugin for DMAN to start and configure the web server.
|
Devicescape Software, Inc.
|
|
|
Access point plugins for the device management agent (device-mgmt-agent)
|
Devicescape Software, Inc.
|
|
ds-config-<Board>
|
Board-specific files
|
Devicescape Software, Inc.
|
|
ds-filesystem
|
|
Devicescape Software, Inc.
|
|
ds-init-wip
|
Initialization scripts for the Devicescape Wireless Infrastructure Platform
|
Devicescape Software, Inc.
|
|
ds-setup
|
Core system files for the Devicescape Wireless Infrastructure Platform
|
Devicescape Software, Inc.
|
|
dnsmasq
|
A DNS forwarder for NAT firewalls
|
|
|
|
Small footprint SSH server and client
|
|
|
ebtables
|
A filtering tool for a bridging firewall
|
|
|
ethtool
|
Ethernet diagnostic and tuning tool
|
|
|
gdbserver
|
Remote server for the GNU Debugger on the runtime side
|
|
|
|
Example application package
|
Devicescape Software, Inc.
|
|
|
Access Point daemon
|
Devicescape Software, Inc. Jouni Malinen
|
|
hwdata
|
Hardware identification and configuration data
|
|
|
|
Devicescape 802.11 stack
|
Devicescape Software, Inc.
|
|
|
Wireless test and manufacturing tools
|
Devicescape Software, Inc.
|
|
insert1q
|
A kernel module to insert vlan tags and read priority information.
|
Devicescape Software, Inc.
|
|
iperf
|
The TCP/UDP Bandwidth Measurement Tool
|
|
|
|
The Itsy Package Manager, a lightweight package manager for installing, uninstalling, and upgrading packages
|
|
|
iproute
|
IP routing utilities
|
|
|
iptables
|
Linux IP packet filtering tools
|
|
|
ixp425
|
IXP4xx access library (ixp425_xscale_sw) and Ethernet driver (ixp425_eth) to support Intel IXP4xx chip package.
|
Intel (1) (ixp425_xscale_sw)
|
|
kernel-arm-ixdpg425
|
Monta Jade kernel
|
|
|
|
C-based local authentication server (LAS) available as an option for use with WPA Enterprise security mode
(Local means that the server is embedded in the wireless device as opposed to an external RADIUS server, which is another option available for use with security modes.)
|
Devicescape Software, Inc.
|
|
libghthash
|
Hash table library
|
|
|
libi802
|
Utility library
|
Devicescape Software, Inc.
|
|
libpcap
|
User-level packet capture library
|
|
|
libevent
|
An event notification library
|
|
|
|
Library for creating LSQL queries
|
Devicescape Software, Inc.
|
|
libstdc++
|
GNU C++ runtime library
|
|
|
libtermcap
|
Termcap database access library
|
|
|
libupnp
|
UPnP
|
|
|
libxml2
|
Large XML library (inc. XPath).
|
|
|
mini-httpd
|
Web server
|
|
|
mtd
|
Linux memory technology device utilities (flash management tools)
|
|
|
net-snmp
|
Simple Network Management Protocol (SNMP) agent. Supports SNMP v.1 and v.2 management information bases (MIBs).
See also web-ui-snmp package
|
|
|
ntpclient
|
Network time protocol client.
See also web-ui-ntp package
|
|
|
openssl-libs
|
The open source toolkit for SSL/TLS
|
|
|
pciutils
|
Portable PCI utilities
|
|
|
portal
|
Guest portal on network
|
Devicescape Software, Inc.
|
|
pptp-linux
|
Linux PPTP
|
|
|
rate-control-<Driver>
|
Rate control functionality for the driver
|
|
|
redboot-config
|
Redboot bootloader configuration package required only for Monte Jade IXDPG425 target boards.
This tool extracts variable values from the 'RedBoot config' partition.
|
|
|
strace
|
System call trace tool
|
|
|
strip1q
|
Kernel module to strip IEEE 802.1q tags and read priority information for the purpose of implementing Layer 2 quality of service (QoS) for non-VLAN frames.
|
Devicescape Software, Inc.
|
|
sysstat
|
System performance tools for Linux
|
|
|
termcap
|
Terminal capability database
|
|
|
|
Small footprint C library
|
|
|
usbutils
|
USB console utilities
|
|
|
vsftpd
|
A very secure FTP daemon. (Replaces simple-ftpd package, which was available in legacy versions of the platform.)
|
|
|
|
Web pages and controller for access point administration.
(Includes Web UI pages for all basic functionality for the Reference AP.)
|
Devicescape Software, Inc.
|
|
|
Online Help starter package for access point Web based Administration UI, generated as a result of building the web-ui-ap-admin package.
(Includes Web UI pages for all basic functionality for the Reference AP and associated Web pages provided by the web-ui-ap-admin package.)
|
Devicescape Software, Inc.
|
|
web-ui-clustering
|
AP Administration Web UI extension for clustering package. (Includes Web pages and Help for cluster management, channel allocation, and wireless neighborhood views.)
|
Devicescape Software, Inc.
|
|
web-ui-las
|
AP Administration Web UI extension for las package (Web page and Help)
|
Devicescape Software, Inc.
|
|
web-ui-ntp
|
AP Administration Web UI extension for ntpclient package (Web page and Help)
The source package for this binary is web-ui-ap-admin-ext.
|
Devicescape Software, Inc.
|
|
web-ui-snmp
|
AP Administration Web UI extension for net-snmp package (Web page and Help)
|
Devicescape Software, Inc.
|
|
web-ui-framework
|
Web application development framework for creating Web based UIs
Builds of web-ui-services and web-ui-ap-admin incorporate libraries from web-ui-framework
Note: This is a development host package.
|
Devicescape Software, Inc.
|
|
web-ui-services
|
Data services for Web UI applications
Builds of web-ui-ap-admin incorporate libraries from web-ui-services.
Note: This is a development host package.
|
Devicescape Software, Inc.
|
|
|
Wireless Tools for Linux
|
|
|
zlib
|
Compression library
|
|
