Base Code merged to SPIN 2.4
[platform/upstream/connman.git] / doc / connman.8
1 .\" connman(8) manual page
2 .\"
3 .\" Copyright (C) 2012 Intel Corporation
4 .\"
5 .TH CONNMAN "8" "21 August 2012"
6 .SH NAME
7 ConnMan \- network management daemon
8 .SH SYNOPSIS
9 .B connmand [\-\-version] | [\-\-help]
10 .PP
11 .B connmand [\-\-config=<filename>] [\-\-debug=<file1>:<file2>:...] [\-\-device=<interface1>,<interface2>,...] [\-\-nodevice=<interface1>,<interface2>,..] [\-\-wifi=<driver1>,<driver2>,...] [\-\-plugin=<plugin1>,<plugin2>,...] [\-\-noplugin=<plugin1>,<plugin2>,...] [\-\-nodaemon] [\-\-nodnsproxy]
12 .SH DESCRIPTION
13 The \fIConnMan\fP provides a daemon for managing internet connections
14 within devices running the Linux operating system. The Connection Manager is
15 designed to be slim and to use as few resources as possible.
16 It is a fully modular system that can be extended, through plug-ins,
17 to support all kinds of wired or wireless technologies.
18 Also, configuration methods, like DHCP and domain name resolving,
19 are implemented using plug-ins.
20 The plug-in approach allows for easy adaption and modification for various
21 use cases.
22 .P
23 .SH OPTIONS
24 The following options are supported:
25 .TP
26 .I "\-\-version"
27 Print the ConnMan software version and exit.
28 .TP
29 .I "\-\-help"
30 Print ConnMan's available options and exit.
31 .TP
32 .I "\-\-config=<filename>"
33 Specify configuration file to set up various settings for ConnMan.  If not
34 specified, the default value of '<SYSCONFDIR>/connman/main.conf'
35 is used; where <SYSCONFDIR> is dependent on your distribution (usually
36 it's /etc).  See \fBconnman.conf\fP(5) for more information on configuration
37 file. The use of config file is optional and sane default values
38 are used if config file is missing.
39 .TP
40 .I "\-\-debug=<file1>:<file2>:..."
41 Sets how much information ConnMan sends to the log destination (usually
42 syslog's "daemon" facility).  If the file options are omitted, then debugging
43 information from all the source files are printed. If file options are
44 present, then only debug prints from that source file are printed.
45 Example: --debug=src/service.c:plugins/wifi.c
46 .TP
47 .I "\-\-device=<interface1>,<interface2>,..."
48 Only manage these network interfaces. By default all network interfaces
49 are managed.
50 .TP
51 .I "\-\-nodevice=<interface1>,<interface2>,..."
52 Never manage these network interfaces.
53 .TP
54 .I "\-\-plugin=<plugin1>,<plugin2>,..."
55 Load these plugins only. The option can be a pattern containing
56 "*" and "?" characters.
57 .TP
58 .I "\-\-noplugin=<plugin1>,<plugin2>,..."
59 Never load these plugins. The option can be a pattern containing
60 "*" and "?" characters.
61 .TP
62 .I "\-\-wifi=<driver1>,<driver2>,..."
63 Wifi driver that WiFi/Supplicant should use. If omitted, then the value
64 of "nl80211,wext" is used by default.
65 .TP
66 .I "\-\-nodaemon"
67 Do not daemonize. This is useful for debugging, and directs log output to
68 the controlling terminal in addition to syslog.
69 .TP
70 .I "\-\-nodnsproxy"
71 Do not act as a DNS proxy. By default ConnMan will direct all DNS traffic
72 to itself by setting nameserver to 127.0.0.1 in \fBresolv.conf\fP(5) file.
73 If this is not desired and you want that all programs call directly some
74 DNS server, then you can use the --nodnsproxy option.
75 If this option is used, then ConnMan is not able to cache the DNS queries
76 because the DNS traffic is not going through ConnMan and that can cause
77 some extra network traffic.
78 .SH SEE ALSO
79 .BR connman.conf (5).