History for pkturnkey

changed:
-
The 'pkturnkey' command line tool almost transforms PyKota into a turn-key solution by importing datas from the operating system into PyKota's DataBase.

However for security reasons, 'pkturnkey' only simulate its actions, unless you really
ask this command to proceed, by using its '--force' command line switch.

Usually, you'll want to execute 'pkturnkey' only once after having installed PyKota, but
launching it several times is entirely safe and may be needed to import more datas, like newly
installed printers, for example.

Functionnalities :

  - Import datas to initialize your PyKota database :

    - Printers are extracted from CUPS' configuration. The subset of printers to import can be
      restricted by passing printers' names as non-option arguments on the command line.

    - Users are extracted from the system in a way similar to that of the 'getent' command, this means that 
      the settings of the '/etc/nsswitch.conf' file are honored. Users are imported 
      into PyKota's DataBase if the '--dousers' (or '-d') command line switch is used. The subset of users
      to import can be restricted with the '--uidmin' (or '-u') and '--uidmax' (or '-U')
      command line switches.

    - Groups are extracted from the system in a way similar to that of the 'getent' command, this means that 
      the settings of the '/etc/nsswitch.conf' file are honored. Groups are 
      imported into PyKota's DataBase if the '--dogroups' (or '-D') command line switch is used. The subset
      of groups to import can be restricted with the '--gidmin' (or '-g') and '--gidmax' (or '-G') 
      command line switches.

  - Tell you which printers are not yet managed by PyKota -- you have to modify CUPS' 'printers.conf' file
    for these, by prepending the 'cupspykota://' string in front of each 'DeviceURI'. Then you have
    to restart CUPS for the change to be taken into account.

  - Give you the best accounting method for your printers, and show you the 'accounter' directives
    to copy and paste into 'pykota.conf'.

  - Additionnal functionnalities might be added in the future.