3
0
mirror of https://git.kernel.org/pub/scm/network/wireless/iwd.git synced 2024-12-23 22:42:37 +01:00
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
2014-05-22 18:48:11 -07:00
client client: Open private bus connection if available 2014-05-20 23:08:14 -07:00
linux build: Add copy of kernel kdbus.h public header 2014-05-20 19:54:16 -07:00
src core: Limit the kdbus attach flags to useful ones 2014-05-21 22:44:31 -07:00
unit unit: Add SHA-1 versions of PBKDF2 and PRF test cases 2014-05-11 11:57:04 -07:00
.gitignore unit: Add SHA-1 versions of PBKDF2 and PRF test cases 2014-05-11 11:57:04 -07:00
AUTHORS AUTHORS: Mention Marcel's contributions 2014-05-11 16:59:26 -07:00
bootstrap build: Add support for internal ELL compilation 2014-05-11 11:01:11 -07:00
bootstrap-configure Initial revision 2014-04-25 17:57:48 -07:00
configure.ac build: Add support for internal ELL compilation 2014-05-11 11:01:11 -07:00
COPYING build: Add COPYING and INSTALL template files 2014-05-22 10:09:24 -07:00
INSTALL build: Add COPYING and INSTALL template files 2014-05-22 10:09:24 -07:00
Makefile.am build: Adjust source files for internal ELL compilation 2014-05-22 18:48:11 -07:00
README README: Add basic information and build instructions 2014-05-21 22:41:40 -07:00

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.