PKUSERS(1)

NOM
pkusers - page de manuel de pkusers 1.26_unofficial

DESCRIPTION
pkusers v1.26_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet - alet@librelogiciel.com

An Users and Groups Manager for PyKota.

command line usage :

    pkusers [options] user1 user2 user3 ... userN

or :

    pkusers --groups [options] group1 group2 group3 ... groupN

options :

-v | --version
    Prints pkusers's version number then exits.

-h | --help
    Prints this message then exits.

-a | --add
    Adds users if they don't exist on the database. If they exist, they are modified unless -s|--skipexisting is also used.

-d | --delete
    Deletes users from the quota storage.

-e | --email addr
    Sets the email address for the users. If the addr parameter begins with @, then the username is prepended to addr to form a valid email address.

-D | --description d Adds a textual description to users or groups.

-g | --groups
    Edit users groups instead of users.

-o | --overcharge f
    Sets the overcharging factor applied to the user when computing the cost of a print job. Positive or negative floating point values are allowed, this allows you to do some really creative things like giving money to an user whenever he prints. The number of pages in a print job is not modified by this coefficient, only the cost of the job for a particular user. Only users have such a coefficient.

-i | --ingroups g1[,g2...]
    Puts the users into each of the groups listed, separated by commas. The groups must already exist in the Quota Storage.

-L | --list
    Lists users or groups.

-l | --limitby l
    Choose if the user/group is limited in printing by its account balance or by its page quota. The default value is 'quota'. Allowed values are 'quota' 'balance' 'noquota' 'noprint' and 'nochange' :

    - quota : limit by number of pages per printer. - balance : limit by number of credits in account. - noquota : no limit, accounting still done. - nochange : no limit, accounting not done. - noprint : printing is denied.

    NB : nochange and noprint are not supported for groups.

-b | --balance b
    Sets the user's account balance to b. Account balance may be increase or decreased if b is prefixed with + or -. WARNING : when decreasing account balance, the total paid so far by the user is decreased too. Groups don't have a real balance, but the sum of their users' account balance.

-C | --comment txt
    Defines some informational text to be associated with a change to an user's account balance. Only meaningful if -b | --balance is also used.

-r | --remove
    In combination with the --ingroups option above, remove users from the specified users groups.

-s | --skipexisting
    In combination with the --add option above, tells pkusers to not modify existing users.

    user1 through userN and group1 through groupN can use wildcards if the --add option is not set.

examples :

    $ pkusers --add john paul george ringo/ringo@example.com

    This will add users john, paul, george and ringo to the quota database. User ringo's email address will also be set to 'ringo@example.com'

    $ pkusers --ingroups coders,it jerome

    User jerome is put into the groups "coders" and "it" which must already exist in the quota database.

    $ pkusers --limitby balance jerome

    This will tell PyKota to limit jerome by his account's balance when printing.

    $ pkusers --balance +10.0 --comment "He paid with his blood !" jerome

    This will increase jerome's account balance by 10.0 (in your own currency). You can decrease the account balance with a dash prefix, and set it to a fixed amount with no prefix. A comment will be stored for this balance change.

    $ pkusers --delete jerome rachel

    This will completely delete jerome and rachel from the quota database. All their quotas and jobs will be deleted too.

    $ pkusers --overcharge 2.5 poorstudent

    This will overcharge the poorstudent user by a factor of 2.5.

    $ pkusers --overcharge -1 jerome

    User jerome will actually earn money whenever he prints.

    $ pkusers --overcharge 0 boss

    User boss can print at will, it won't cost him anything because the cost of each print job will be multiplied by zero before charging his account.

    $ pkusers --email @example.com

    This will set the email address for each user to username@example.com

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Please report bugs to : Jerome Alet - alet@librelogiciel.com