archassistant/README.txt

   1 - ArchAssistant v0.4 -
   2 ----------------------
   3
   4 ABOUT:
   5 ------
   6  ArchAssistant is a systray docking app that lets you have quick access to various administration aspects of the Arch Linux distro. The main feature is a gui for the Arch's network profiles system (using the netcfg command line), which is very useful for laptop users.
   7
   8 FEATURES:
   9 ---------
  10 - quick access to the main system files (ie rc.conf, profile, pacman.conf, xorg.conf ...) via a built-in simple text editor.
  11 - netcfg2 front-end : quite complete GUI for the Arch's network profile system. You can connect to, create and edit network profiles in a few clicks. ArchAssistant has an autostart functionality that lets the app connect to the first wifi network discovered upon start.
  12 - the pacman part has been mostly disabled (didn't work as expected).
  13 - collection of the most useful command lines to check system informations.
  14 - custom app launcher from menu
  15 - download clipboard's url with your favorite download manager
  16 - load/eject CD-ROM tray
  17 - instant connection wizard
  18 - english, french, german translations
  19
  20 REQUIREMENTS:
  21 -------------
  22 - arch linux distro !
  23 - QT (I mean qt4)
  24 - netcfg2
  25
  26
  27 CHANGELOG:
  28 ----------
  29   Version 0.1 (launched 2007/10/04)
  30   Version 0.2 (released 2008/03/11)
  31   Version 0.3 (released 2008/03/24)
  32   Version 0.4 (released 2008/05/08)
  33
  34 INSTALL:
  35 --------
  36   - cd in the uncompressed source tarball's directory : # cd archassistant-0.4
  37   - # qmake archassitant.pro
  38   - # make
  39   - run the provided install.sh script : # ./install.sh
  40   - type 'archassistant' from the command line or click 'ArchAssistant' from the 'System' menu
  41
  42 UNINSTALL:
  43 ----------
  44   - # ./uninstall.sh
  45
  46 READ NON-ROOT USERS:
  47 --------------------
  48   Archassistant uses 'netcfg2' as a backend to connect the networks. Unfortunately, netcfg2 cannot be run by non-root users. This is a problem. Another one is that '/etc/network.d' folder, where profiles are stored, cannot be written by non-root users. What can be done :
  49
  50   1/ edit '/etc/sudoers' file as root and insert entries like these :
  51
  52      # User alias specification
  53      User_Alias NETPROFILERS=lisa, homer, marge, bart
  54
  55      # Cmnd alias specification
  56      Cmnd_Alias NETPROFILES=/sbin/ifconfig,/usr/bin/iwconfig,/usr/sbin/iwlist,/usr/bin/netcfg2,/bin/hostname,/usr/sbin/lspci
  57
  58      # User privilege specification
  59      NETPROFILERS       ALL=NOPASSWD: NETPROFILES
  60
  61   2/ change permissions for '/etc/network.d' directory. For instance, you may change the group owner to a group where your users belong (for example, the group 'network'). Example :
  62
  63      chgrp -R network /etc/network.d/
  64
  65 LICENSE:
  66 --------
  67  G.P.L. 2.0
  68
  69 CONTACT:
  70 --------
  71  - author : thierry deseez
  72  - e-mail : pizza.tony@free.fr
  73  - website : www.qt-apps.org or kde-apps.org