The iNet Wireless Daemon (iwd) project aims to provide a comprehensive Wi-Fi connectivity solution for Linux based devices. The core goal of the project is to optimize resource utilization: storage, runtime memory and link-time costs. https://iwd.wiki.kernel.org/
Go to file
Denis Kenzior 2c0e997ee8 build: Avoid redefining _FORTIFY_SOURCE
Gentoo (and others) define _FORTIFY_SOURCE=2 by default.  Since we
always define it as well, this results in redefinition warnings &
configure failure.
2014-08-01 09:52:36 -05:00
client client: Open private bus connection if available 2014-05-20 23:08:14 -07:00
doc doc: Prefer !var over var == NULL checks 2014-07-20 17:48:48 +02:00
linux build: Add copy of kernel kdbus.h public header 2014-05-20 19:54:16 -07:00
src ie: Adding IE builder support 2014-07-31 09:58:58 -05:00
unit unit: Take out unused function 2014-07-31 10:18:47 -05:00
.gitignore .gitignore: Ignore test-ie 2014-07-15 19:18:08 -05:00
AUTHORS AUTHORS: Mention Jukka's contributions 2014-07-15 19:18:08 -05:00
COPYING build: Add COPYING and INSTALL template files 2014-05-22 10:09:24 -07:00
ChangeLog build: Add ChangeLog file to satisfy distribution requirements 2014-05-22 19:53:56 -07:00
INSTALL build: Add COPYING and INSTALL template files 2014-05-22 10:09:24 -07:00
Makefile.am core: Add skeleton for nl80211 setup 2014-07-29 21:25:01 +02:00
README README: Add basic information and build instructions 2014-05-21 22:41:40 -07:00
acinclude.m4 build: Avoid redefining _FORTIFY_SOURCE 2014-08-01 09:52:36 -05:00
bootstrap build: Add support for internal ELL compilation 2014-05-11 11:01:11 -07:00
bootstrap-configure build: Add debug options to configure 2014-07-16 02:10:15 +02:00
configure.ac build: Add debug options to configure 2014-07-16 02:10:15 +02:00

README

Wireless daemon for Linux
*************************

Copyright (C) 2013-2014  Intel Corporation. All rights reserved.


Compilation and installation
============================

In order to compile the source code you need following software packages:
	- GCC compiler
	- GNU C library
	- Embedded Linux library

To configure run:
	./configure --prefix=/usr

Configure automatically searches for all required components and packages.

To compile and install run:
	make && make install


Embedded Linux library
======================

In order to compile the daemon and control utility the development version
of Embedded Linux library is required to be present. The development
repositories can be found here:

	git://git.kernel.org/pub/scm/libs/ell/ell.git
	https://kernel.googlesource.com/pub/scm/libs/ell/ell.git

The build systems requires that the Embedded Linux library source code
is available on the same top level directory as the Wireless daemon
source code:

	.
	|--- ell
	|    |--- ell
	|    `--- unit
	`--- iwd
	     |--- src
	     `--- client

It is not required to build or install Embedded Linux library. The build
will happen when building the Wireless daemon and it will then be linked
internally.


Kernel dependencies
===================

In order to use this daemon and control utility the kdbus kernel module
is required. The development repositories can be found here:

	https://github.com/gregkh/kdbus
	https://code.google.com/p/d-bus/

The daemon will start its own private bus that is located at the /dev/kdbus
device hierarchy:

	/dev/kdbus
	|--- control
	`--- 0-iwd
	     `--- bus

When started as root, the new private bus will be /dev/kdbus/0-iwd/bus
and it can be verified with the busctl utility from systemd:

	# busctl --address=kernel:path=/dev/kdbus/0-iwd/bus
	NAME       PID  PROCESS     USER      CONNECTION    CONNECTION-NAME
	:1.1     62151  iwd         root      :1.1          iwd
	:1.2     62153  busctl      root      :1.2          sd-busctl

Clients talking to the daemon must specifiy the private bus address.