/usr/bin/cipux_task

#!/usr/bin/perl -w -T

eval 'exec /usr/bin/perl -w -T -S $0 ${1+"$@"}'
    if 0; # not running under some shell
# +==========================================================================+
# || Copyright (C) 2007 - 2010 by Christian Kuelker                         ||
# ||                                                                        ||
# || License: GNU General Public License - GNU GPL - version 2              ||
# ||          or (at your opinion) any later version                        ||
# +==========================================================================+
# ID:       $Id$
# Revision: $Revision$
# Head URL: $HeadURL$
# Date:     $Date$
# Source:   $Source

use 5.008001;
use strict;
use warnings;
use CipUX::Task::Client;
use version; our $VERSION = qv('3.4.0.7');
delete @ENV{qw(PATH IFS CDPATH ENV BASH_ENV)};    # Make %ENV safer

# MAIN
my $client = CipUX::Task::Client->new( { name => 'cipux_task_client' } );

$client->run( { script => 'cipux_task_client' } );

exit 0;

=pod

=head1 NAME

command line interface to CipUX Task library

=head1 VERSION

version 3.4.0.7

=head1 SYNOPSIS

 cipux_task_client [OPTION] -t <TASK> -o <OBJECT> [-x|-y <ATTR>=<VALUE>]

 abbreviations: ATTR = ATTRIBUTE

=head1 OPTIONS

        Options for all commands:

        -c | --cfg             : cipux-task.conf
        -D | --debug           : print debug messages for developers
        -h | --help            : print help (this message + options)
        -V | --version         : print only version

        Options for some commands:

        -t | --task           : CipUX::Task command
        -x | --mattrvalue     : multiple LDAP attributes, please see
                                description
        -y | --attrvalue      : one LDAP attribute with multible values,
                                please see description


=head1 DESCRIPTION OF OPTIONS

=over 4

=item I<--attrvalue>

This is option have to be use if a LDAP attribute of object has no possibility
to search or do not know its own equality. This attributes are rather seldom,
nisNetgroupTriple is such an attribute. It is used for clients of netgroups. If
you are not sure use --mattrvalue (-x) instaed. If you want to set a values you
should provide them like this:

  --attrvalue <ATTRIBUTE>=<VALUE>

If you want to delete all values of that attribute you can just provide:

  --attrvalue <ATTRIBUTE>

=item I<-c>

Same as option --cfg.

=item I<--cfg>

To specify the configuration file, if any. The default location for the
configuration file is:

 (1) ~/.cipux/cipux-task.yaml

or

 (2) /etc/cipux/cipux-task.yaml

If both are missing, you have to use this option --cfg to specify one.

=item I<-D>

Same as option --debug.

=item I<--debug>

To see more output, what the internals is doing, you can enable the --debug and
see more message printed to STDOUT.

The suggestion is not to use debug output for production code.

=item I<-h>

Same as option --help

=item I<--help>

Prints brief help message.

=item I<--mattrvalue>

This is option have to be use if a LDAP object has to be created. This option
requires always an attribute and a value. Therefore only this syntax is
possible:

  --mattrvalue <ATTRIBUTE>=<VALUE>

The reason for this is to be able to gave the user exact hints when he try to
create a object but forget the value.

The "m" stands for multiple. So it is possible to give the option several
times.

=item I<-o>

Same as option --object

=item I<--object>

This option is used to specify the object on which the command is operating.
Make sure you choose the right object. Of course this will also fail when the
object is not fetchable with (in the objects list of) --task.

=item I<-t>

Same as option --task.

=item I<--task>

This option defines the "task name" the command is operating with. A "task
name" is a certain command inside the CipUX Task Library. For example
"cipux_task_create room". You can easily define new tasks in the configuration
file. The default location of this file is /etc/cipux/cipux-task.yaml.

=item I<-V>

Same as option --version.

=item I<--version>

Prints the version and exits.

=item I<-x>

Same as option --mattrvalue.

=item I<-y>

Same as option --attrvalue.

=back

=head1 COMMANDS

 cipux_task_client

=head1 SEE ALSO

See the CipUX webpage and the manual at L<http://www.cipux.org>

See the mailing list L<http://sympa.cipworx.org/wws/info/cipux-devel>

=head1 AUTHOR

Christian Kuelker  E<lt>christian.kuelker@cipworx.orgE<gt>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2007 - 2010 by Christian Kuelker

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, 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., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA

=cut
cipux-task-tools 3.4.0.7-4 / usr / bin / cipux_task_client
