Debian Bug report logs - #637769
network-manager: please provide an example system-connections file

version graph

Package: network-manager; Maintainer for network-manager is Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>; Source for network-manager is src:network-manager.

Reported by: Tzafrir Cohen <tzafrir@debian.org>

Date: Sun, 14 Aug 2011 09:09:01 UTC

Severity: wishlist

Tags: patch

Found in version network-manager/0.8.4.0-2

Reply or subscribe to this bug.

Toggle useless messages

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to debian-bugs-dist@lists.debian.org, Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>:
Bug#637769; Package network-manager. (Sun, 14 Aug 2011 09:09:04 GMT) Full text and rfc822 format available.

Acknowledgement sent to Tzafrir Cohen <tzafrir@debian.org>:
New Bug report received and forwarded. Copy sent to Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>. (Sun, 14 Aug 2011 09:09:04 GMT) Full text and rfc822 format available.

Message #5 received at submit@bugs.debian.org (full text, mbox):

From: Tzafrir Cohen <tzafrir@debian.org>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: network-manager: please provide an example system-connections file
Date: Sun, 14 Aug 2011 12:05:06 +0300
Package: network-manager
Version: 0.8.4.0-2
Severity: wishlist
Tags: patch


Below is an example system-connection file I used in the recent weeks.
It seems to be good enough for practically anyhwere, even though it
only configures wifi (unencrypted, WPA2-psk and WEP).

As implied from the text, including the reference (settings-spec.html)
in the package would also be nice.


# The following is a simple NetworkManager system connection file
# Edit it and drop it over to /etc/NetworkManager/system-connections
# 
# Be sure to set the UUID for each new connections file.
#
# The NetworkManager daemon watched that directory (with inotify), so no
# need to poke it after dropping the file there.
#
# This file only includes some common options. For a full reference, see
# /usr/share/doc/network-manager/settings-spec.html .

[connection]
type=802-11-wireless
id=an_arbitrary_name
## You MUST create a new uuid. use the output of e.g. genuuid or 
## 'cat /proc/sys/kernel/random/uuid'. Be sure to recreate it after
## copying one file to another
#uuid=d126879a-fef8-4665-9aa8-4c55499221a5

[802-11-wireless]
ssid=the_bssid_of_the_access_point
mode=infrastructure

## Only enable this if the connection is encrypted:
#security=802-11-wireless-security

# Also be sure to set the proper values in the following section:

[802-11-wireless-security]

## WPA2:
#key-mgmt=wpa-psk
#psk=The Secret

## WEP:
#key-mgmt=none
#wep-key0=0011223344

-- 
Tzafrir Cohen         | tzafrir@jabber.org | VIM is
http://tzafrir.org.il |                    | a Mutt's
tzafrir@cohens.org.il |                    |  best
tzafrir@debian.org    |                    | friend




Information forwarded to debian-bugs-dist@lists.debian.org, Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>:
Bug#637769; Package network-manager. (Wed, 04 Apr 2012 14:33:09 GMT) Full text and rfc822 format available.

Acknowledgement sent to Tzafrir Cohen <tzafrir@cohens.org.il>:
Extra info received and forwarded to list. Copy sent to Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>. (Wed, 04 Apr 2012 14:33:09 GMT) Full text and rfc822 format available.

Message #10 received at 637769@bugs.debian.org (full text, mbox):

From: Tzafrir Cohen <tzafrir@cohens.org.il>
To: 637769@bugs.debian.org
Subject: Re: #637769: network-manager: please provide an example system-connections file
Date: Wed, 4 Apr 2012 14:28:34 +0000
[Message part 1 (text/plain, inline)]
Update: a simple script to generate simple system-connections entry for
a wi-fi connection.

-- 
Tzafrir Cohen         | tzafrir@jabber.org | VIM is
http://tzafrir.org.il |                    | a Mutt's
tzafrir@cohens.org.il |                    |  best
tzafrir@debian.org    |                    | friend
[mk_nm_con (text/plain, attachment)]

Information forwarded to debian-bugs-dist@lists.debian.org, Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>:
Bug#637769; Package network-manager. (Wed, 04 Apr 2012 15:27:03 GMT) Full text and rfc822 format available.

Acknowledgement sent to Michael Biebl <biebl@debian.org>:
Extra info received and forwarded to list. Copy sent to Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>. (Wed, 04 Apr 2012 15:27:04 GMT) Full text and rfc822 format available.

Message #15 received at 637769@bugs.debian.org (full text, mbox):

From: Michael Biebl <biebl@debian.org>
To: Tzafrir Cohen <tzafrir@cohens.org.il>, 637769@bugs.debian.org
Subject: Re: [Pkg-utopia-maintainers] Bug#637769: #637769: network-manager: please provide an example system-connections file
Date: Wed, 04 Apr 2012 17:23:24 +0200
[Message part 1 (text/plain, inline)]
On 04.04.2012 16:28, Tzafrir Cohen wrote:
> Update: a simple script to generate simple system-connections entry for
> a wi-fi connection.

thanks for the script, but I'm a bit uncertain about shipping it system
wide. People might get used to it and then it's hard to get rid of it
again. Maybe as example script in /usr/share/doc.

That said, we seriously need to grow a
"nmcli con add" command.

Michael


-- 
Why is it that all of the instruments seeking intelligent life in the
universe are pointed away from Earth?

[signature.asc (application/pgp-signature, attachment)]

Information forwarded to debian-bugs-dist@lists.debian.org, Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>:
Bug#637769; Package network-manager. (Fri, 06 Apr 2012 00:00:33 GMT) Full text and rfc822 format available.

Acknowledgement sent to Luca Capello <luca@pca.it>:
Extra info received and forwarded to list. Copy sent to Utopia Maintenance Team <pkg-utopia-maintainers@lists.alioth.debian.org>. (Fri, 06 Apr 2012 00:00:33 GMT) Full text and rfc822 format available.

Message #20 received at 637769@bugs.debian.org (full text, mbox):

From: Luca Capello <luca@pca.it>
To: Tzafrir Cohen <tzafrir@debian.org>
Cc: 637769@bugs.debian.org
Subject: Re: Bug#637769: network-manager: please provide an example system-connections file
Date: Fri, 06 Apr 2012 01:57:16 +0200
[Message part 1 (text/plain, inline)]
usertags 637769 + pca.it-communication
thanks

Hi there!

I just found out that this bug got more attention during the last days,
while I was preparing (and testing) the patch below.  I decided to
anyway sent this email because it was ready (I was simply waiting to
come back online, check the Git repository and commit...).

Because of the ongoing discussion on debian-devel@ (thanks to Josselin
and Michal) I discovered that it is actually possible to use
network-manager without the GUI:

  <http://lists.debian.org/1332506635.4294.9.camel@tomoyo>
  <http://lists.debian.org/20120323135014.02ca5696@rincewind.suse.cz>

This bug is tightly-linked to #641902, because ATM there is no way to
create a connection through nmcli.

On Sun, 14 Aug 2011 11:05:06 +0200, Tzafrir Cohen wrote:
> Below is an example system-connection file I used in the recent weeks.
> It seems to be good enough for practically anyhwere, even though it
> only configures wifi (unencrypted, WPA2-psk and WEP).
>
> As implied from the text, including the reference (settings-spec.html)
> in the package would also be nice.

The other option would be to include a fully-commented system-connection
file similar to what wpasupplicant does, with the disadvantage that it
should be manually updated over time:

  <file:///usr/share/doc/wpasupplicant/examples/wpa_supplicant.conf.gz>

OTOH, the reference file (since 0.9 called ref-settings.html despite the
HTML title still says "Network Configuration Setting Specification") is
already shipped by the network-manager-dev package (FWIW not really in a
"standard" location):

  <file:///usr/share/gtk-doc/html/NetworkManager/ref-settings.html>

IMHO the best option would be to include a basic example which explains
the format of system-connection files and directs to the full
network-manager-dev package.

Attached a Git and improved version of your patch, with some notes:

1) I was not able to find 'genuuid' in Debian sid, so I replaced it with
   uuidgen (shipped by the uuid-runtime package).

2) a symlink to /usr/share/gtk-doc/html/NetworkManager/ is created in
   /usr/share/doc/network-manager-dev/html to ease documentation lookup.

On Wed, 04 Apr 2012 17:23:24 +0200, Michael Biebl wrote:
> On 04.04.2012 16:28, Tzafrir Cohen wrote:
>> Update: a simple script to generate simple system-connections entry for
>> a wi-fi connection.
>
> thanks for the script, but I'm a bit uncertain about shipping it system
> wide. People might get used to it and then it's hard to get rid of it
> again. Maybe as example script in /usr/share/doc.

I have not tried Tzafrir's script, but any solution not involving nmcli
still requires root access to /etc/NetworkManager/system-connections/,
thus it is suboptimal.

> That said, we seriously need to grow a
> "nmcli con add" command.

Which, as I wrote at the beginning, is #641902.  Nevertheless, having
better documentation is still useful.

Thx, bye,
Gismo / Luca

[0001-debian-system-connection_wireless-Closes-637769-new-.patch (text/x-diff, attachment)]
[Message part 3 (application/pgp-signature, inline)]

Send a report that this bug log contains spam.


Debian bug tracking system administrator <owner@bugs.debian.org>. Last modified: Mon Apr 21 03:16:53 2014; Machine Name: beach.debian.org

Debian Bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.