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