Re: 3G; wireless auth; policies; docs

2008-07-17 Thread Martin Vidner
On Wed, Jul 16, 2008 at 05:53:06PM -0300, [EMAIL PROTECTED] wrote:
> Thanks for the quick answer.
> 
> The --with-docs tag worked but spec.html is generated only when I run 
> 'make' for
> the second time. In the first time it gives me this error and stops the 
> compilation:
> 
> """
> xsltproc --xinclude --nonet tools/doc-generator.xsl introspection/all.xml 
> > docs/spec.html
> ERR: Unable to find type 'NM_DEVICE_STATE_REASON'
> make: *** [docs/spec.html] Error 10
> """

I made a stub API documentation pointing at a static copy of
spec.html:
http://live.gnome.org/NetworkManagerDBusInterface

It would be great if Dan or someone could host a more frequently
updated copy.

-- 
Martin Vidner, YaST developer
http://en.opensuse.org/User:Mvidner

Kuracke oddeleni v restauraci je jako fekalni oddeleni v bazenu
___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


Re: 3G; wireless auth; policies; docs

2008-07-16 Thread Dan Williams
On Wed, 2008-07-16 at 17:53 -0300, [EMAIL PROTECTED] wrote:
> 
> Thanks for the quick answer. 
> 
> The --with-docs tag worked but spec.html is generated only when I run
> 'make' for 
> the second time. In the first time it gives me this error and stops
> the compilation: 
> 
> """ 
> xsltproc --xinclude --nonet tools/doc-generator.xsl
> introspection/all.xml > docs/spec.html 
> ERR: Unable to find type 'NM_DEVICE_STATE_REASON' 
> make: *** [docs/spec.html] Error 10 
> """ 

Good catch, I need to update the docs for state reasons.

> 
> Also, the spec file generated has few methods/signals ... only for
> interfaces org.freedesktop.NetworkManager, 
> org.freedesktop.NetworkManager.AccessPoint and
> org.freedesktop.NetworkManager.Device. Is this right ? 

No, sounds wrong.  I'll look into it.

> I know that documentation is not the major priority now, but I'm
> looking for a way to make Network Manager 
> connects to a given wireless (SSID). Any ideas ? 

A pointer would be cnetworkmanager, or the applet itself.  Will this
functionality be run concurrently with nm-applet, or are you looking to
replace nm-applet?  Are you by chance implementing the "Connect" button
in the connection editor for Grant or John W.? :)

Dan

> Thanks 
> 
> Rodrigo Trujillo 
> 
> 
> 
> From: 
> Dan Williams <[EMAIL PROTECTED]> 
> To: 
> [EMAIL PROTECTED] 
> Cc: 
> networkmanager-list@gnome.org 
> Date: 
> 07/16/2008 04:58 PM 
> Subject: 
> Re: 3G; wireless auth; policies;
> docs
> 
> 
> __
> 
> 
> 
> On Wed, 2008-07-16 at 16:26 -0300, [EMAIL PROTECTED] wrote:
> > 
> > Where is the spec.html file ??
> > I could not find or generate it. 
> 
> If you run configure or autogen.sh with --with-docs you should get a
> generated spec.html after the build is done.
> 
> Dan
> 
> 
> 
> ___
> NetworkManager-list mailing list
> NetworkManager-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/networkmanager-list

___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


Re: 3G; wireless auth; policies; docs

2008-07-16 Thread rotru
Thanks for the quick answer.

The --with-docs tag worked but spec.html is generated only when I run 
'make' for
the second time. In the first time it gives me this error and stops the 
compilation:

"""
xsltproc --xinclude --nonet tools/doc-generator.xsl introspection/all.xml 
> docs/spec.html
ERR: Unable to find type 'NM_DEVICE_STATE_REASON'
make: *** [docs/spec.html] Error 10
"""


Also, the spec file generated has few methods/signals ... only for 
interfaces org.freedesktop.NetworkManager,
org.freedesktop.NetworkManager.AccessPoint and 
org.freedesktop.NetworkManager.Device. Is this right ?

I know that documentation is not the major priority now, but I'm looking 
for a way to make Network Manager
connects to a given wireless (SSID). Any ideas ?

Thanks

Rodrigo Trujillo




From:
Dan Williams <[EMAIL PROTECTED]>
To:
[EMAIL PROTECTED]
Cc:
networkmanager-list@gnome.org
Date:
07/16/2008 04:58 PM
Subject:
Re: 3G; wireless auth; policies; docs



On Wed, 2008-07-16 at 16:26 -0300, [EMAIL PROTECTED] wrote:
> 
> Where is the spec.html file ??
> I could not find or generate it. 

If you run configure or autogen.sh with --with-docs you should get a
generated spec.html after the build is done.

Dan



___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


Re: 3G; wireless auth; policies; docs

2008-07-16 Thread Dan Williams
On Wed, 2008-07-16 at 16:26 -0300, [EMAIL PROTECTED] wrote:
> 
> Where is the spec.html file ??
> I could not find or generate it. 

If you run configure or autogen.sh with --with-docs you should get a
generated spec.html after the build is done.

Dan

> 
> Thanks 
> 
> Rodrigo Trujillo 
> 
> 
> From: 
> Dan Williams <[EMAIL PROTECTED]> 
> To: 
> Jens-Michael Hoffmann
> <[EMAIL PROTECTED]> 
> Cc: 
> Alexey Dumov <[EMAIL PROTECTED]>,
> networkmanager mailing list
> ,
> Ferenc Sos <[EMAIL PROTECTED]> 
> Date: 
> 07/03/2008 06:19 PM 
> Subject: 
> Re: 3G; wireless auth; policies;
> docs
> 
> 
> __
> 
> 
> 
> On Thu, 2008-07-03 at 13:14 +0200, Jens-Michael Hoffmann wrote:
> > Hi,
> > 
> > first of all let me thank you for your great work and
> NetworkManager.
> 
> Great to see your interest.  I'd like to ensure that Option cards work
> as well as possible with NetworkManager.
> 
> > We are currently evaluating NetworkManager and would like to ask
> some
> > questions:
> > 
> > What is the status of support for 3G devices?
> 
> We have fairly basic support for connecting, disconnecting, setting
> APN,
> PIN/PUK handling, username, password, etc.  Planned support includes
> band preference, roaming preference, etc.  I'd like to implement
> rfkill
> as well but we really do need a standard kernel interface for that
> which
> would live in the 'option' driver in the kernel and hook into the WWAN
> rfkill functionality in 2.6.26 and later.
> 
> > How and where are policies (like choose wired over wireless)
> implemented?
> 
> It's fairly basic right now.  But I'm certainly willing to discuss
> more
> flexible priority handling
> 
> > Is it possible to do connect on demand with NetwokManager?
> 
> Not at this time, I need to figure out how that's supposed to work.
> ISTR it involves creating a 'fake' network device and having userspace
> hooks called whenever something starts sending out traffic or bringing
> the device up, but I actually have no idea.  Definitely something I
> want
> to support though.
> 
> > How is the wireless authentication stuff (WEP/WPA/WPA2) handled?
> > Are there callbacks to get the keys or any other mechanism?
> 
> Yes.  When NM (or the user) wishes to connect to a wireless network
> and
> does not have the required authentication secrets for that network, it
> will ask the daemon that provides that connection.  This is either the
> system settings daemon (nm-system-settings) or the applet running in
> the
> user's session (nm-applet or knetworkmanager).  If the settings deamon
> does not have the secrets required, it will ask the user for them.
> 
> > Is there any kind of documentation apart from the generated
> spec.html?
> > We are especially looking for developer documentation.
> 
> At this time the documentation consists of the generated spec.html,
> which is really only useful if you are intending to write your own
> front-end to NetworkManager (talking over D-Bus of course).  You could
> also use libnm-glib which provides an object-oriented wrapper around
> the
> dbus interface.
> 
> I will be adding doxygen/gtkdoc a bit later this summer to libnm-util
> and libnm-glib, but in the mean time, both Tambet and I would be quite
> happy to answer any questions you might have.
> 
> The D-Bus and libnm-glib APIs are not _quite_ final yet, but they are
> pretty darn close and I don't expect them to change much.  The one
> change I will be making quite soon is using IPv4 prefixes instead of
> IPv4 netmasks through out the API and the UI.
> 
> Dan
> 
> > 
> > Best regards
> > 
> > Jens-Michael Hoffmann
> > ___
> > NetworkManager-list mailing list
> > NetworkManager-list@gnome.org
> > http://mail.gnome.org/mailman/listinfo/networkmanager-list
> 
> ___
> NetworkManager-list mailing list
> NetworkManager-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/networkmanager-list
> 
> 
> ___
> NetworkManager-list mailing list
> NetworkManager-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/networkmanager-list

___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


Re: 3G; wireless auth; policies; docs

2008-07-16 Thread rotru
Where is the spec.html file ??
I could not find or generate it.


Thanks

Rodrigo Trujillo



From:
Dan Williams <[EMAIL PROTECTED]>
To:
Jens-Michael Hoffmann <[EMAIL PROTECTED]>
Cc:
Alexey Dumov <[EMAIL PROTECTED]>, networkmanager mailing list 
, Ferenc Sos <[EMAIL PROTECTED]>
Date:
07/03/2008 06:19 PM
Subject:
Re: 3G; wireless auth; policies; docs



On Thu, 2008-07-03 at 13:14 +0200, Jens-Michael Hoffmann wrote:
> Hi,
> 
> first of all let me thank you for your great work and NetworkManager.

Great to see your interest.  I'd like to ensure that Option cards work
as well as possible with NetworkManager.

> We are currently evaluating NetworkManager and would like to ask some
> questions:
> 
> What is the status of support for 3G devices?

We have fairly basic support for connecting, disconnecting, setting APN,
PIN/PUK handling, username, password, etc.  Planned support includes
band preference, roaming preference, etc.  I'd like to implement rfkill
as well but we really do need a standard kernel interface for that which
would live in the 'option' driver in the kernel and hook into the WWAN
rfkill functionality in 2.6.26 and later.

> How and where are policies (like choose wired over wireless) 
implemented?

It's fairly basic right now.  But I'm certainly willing to discuss more
flexible priority handling

> Is it possible to do connect on demand with NetwokManager?

Not at this time, I need to figure out how that's supposed to work.
ISTR it involves creating a 'fake' network device and having userspace
hooks called whenever something starts sending out traffic or bringing
the device up, but I actually have no idea.  Definitely something I want
to support though.

> How is the wireless authentication stuff (WEP/WPA/WPA2) handled?
> Are there callbacks to get the keys or any other mechanism?

Yes.  When NM (or the user) wishes to connect to a wireless network and
does not have the required authentication secrets for that network, it
will ask the daemon that provides that connection.  This is either the
system settings daemon (nm-system-settings) or the applet running in the
user's session (nm-applet or knetworkmanager).  If the settings deamon
does not have the secrets required, it will ask the user for them.

> Is there any kind of documentation apart from the generated spec.html?
> We are especially looking for developer documentation.

At this time the documentation consists of the generated spec.html,
which is really only useful if you are intending to write your own
front-end to NetworkManager (talking over D-Bus of course).  You could
also use libnm-glib which provides an object-oriented wrapper around the
dbus interface.

I will be adding doxygen/gtkdoc a bit later this summer to libnm-util
and libnm-glib, but in the mean time, both Tambet and I would be quite
happy to answer any questions you might have.

The D-Bus and libnm-glib APIs are not _quite_ final yet, but they are
pretty darn close and I don't expect them to change much.  The one
change I will be making quite soon is using IPv4 prefixes instead of
IPv4 netmasks through out the API and the UI.

Dan

> 
> Best regards
> 
> Jens-Michael Hoffmann
> ___
> NetworkManager-list mailing list
> NetworkManager-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/networkmanager-list

___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


Re: 3G; wireless auth; policies; docs

2008-07-03 Thread Dan Williams
On Thu, 2008-07-03 at 13:14 +0200, Jens-Michael Hoffmann wrote:
> Hi,
> 
> first of all let me thank you for your great work and NetworkManager.

Great to see your interest.  I'd like to ensure that Option cards work
as well as possible with NetworkManager.

> We are currently evaluating NetworkManager and would like to ask some
> questions:
> 
> What is the status of support for 3G devices?

We have fairly basic support for connecting, disconnecting, setting APN,
PIN/PUK handling, username, password, etc.  Planned support includes
band preference, roaming preference, etc.  I'd like to implement rfkill
as well but we really do need a standard kernel interface for that which
would live in the 'option' driver in the kernel and hook into the WWAN
rfkill functionality in 2.6.26 and later.

> How and where are policies (like choose wired over wireless) implemented?

It's fairly basic right now.  But I'm certainly willing to discuss more
flexible priority handling

> Is it possible to do connect on demand with NetwokManager?

Not at this time, I need to figure out how that's supposed to work.
ISTR it involves creating a 'fake' network device and having userspace
hooks called whenever something starts sending out traffic or bringing
the device up, but I actually have no idea.  Definitely something I want
to support though.

> How is the wireless authentication stuff (WEP/WPA/WPA2) handled?
> Are there callbacks to get the keys or any other mechanism?

Yes.  When NM (or the user) wishes to connect to a wireless network and
does not have the required authentication secrets for that network, it
will ask the daemon that provides that connection.  This is either the
system settings daemon (nm-system-settings) or the applet running in the
user's session (nm-applet or knetworkmanager).  If the settings deamon
does not have the secrets required, it will ask the user for them.

> Is there any kind of documentation apart from the generated spec.html?
> We are especially looking for developer documentation.

At this time the documentation consists of the generated spec.html,
which is really only useful if you are intending to write your own
front-end to NetworkManager (talking over D-Bus of course).  You could
also use libnm-glib which provides an object-oriented wrapper around the
dbus interface.

I will be adding doxygen/gtkdoc a bit later this summer to libnm-util
and libnm-glib, but in the mean time, both Tambet and I would be quite
happy to answer any questions you might have.

The D-Bus and libnm-glib APIs are not _quite_ final yet, but they are
pretty darn close and I don't expect them to change much.  The one
change I will be making quite soon is using IPv4 prefixes instead of
IPv4 netmasks through out the API and the UI.

Dan

> 
> Best regards
> 
> Jens-Michael Hoffmann
> ___
> NetworkManager-list mailing list
> NetworkManager-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/networkmanager-list

___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


Re: 3G; wireless auth; policies; docs

2008-07-03 Thread Markus Becker


On Thu, 3 Jul 2008, Jens-Michael Hoffmann wrote:


Hi,

first of all let me thank you for your great work and NetworkManager.

We are currently evaluating NetworkManager and would like to ask some
questions:

What is the status of support for 3G devices?


Works very nicely for me with Option Fusion+ (:-)) and others. However the 
cards sometimes report bogus DNS server IP addresses, see e.g. 
http://www.mail-archive.com/networkmanager-list%40gnome.org/msg08359.html



How and where are policies (like choose wired over wireless) implemented?


In NetworkManagerPolicy.c: get_device_priority()


Is it possible to do connect on demand with NetwokManager?

How is the wireless authentication stuff (WEP/WPA/WPA2) handled?
Are there callbacks to get the keys or any other mechanism?

Is there any kind of documentation apart from the generated spec.html?
We are especially looking for developer documentation.


Best regards

Jens-Michael Hoffmann
___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list


___
NetworkManager-list mailing list
NetworkManager-list@gnome.org
http://mail.gnome.org/mailman/listinfo/networkmanager-list