Setup::Unix::Group - Setup Unix group (existence)
This document describes version 0.12 of Setup::Unix::Group (from Perl distribution Setup-Unix-User), released on 2015-08-18.
Setup
Setup::Unix::User
{en_US Add group}.
This function is idempotent (repeated invocations with same arguments has the same effect as single invocation). This function supports transactions.
Arguments ('*' denotes required arguments):
etc_dir => str (default: "/etc")
{en_US Location of passwd files}.
gid => int
{en_US Add with specified GID}.
{en_US If not specified, will search an unused GID from min_new_gid to max_new_gid.
min_new_gid
max_new_gid
If specified, will accept non-unique GID (that which has been used by other group). }
group => str
{en_US Group name}.
max_gid => int (default: 65534)
{en_US Specify range for new GID}.
{en_US If a free GID between min_gid and max_gid is not available, an error is returned.
min_gid
max_gid
Passed to Unix::Passwd::File's max_new_gid. }
min_gid => int (default: 1000)
Passed to Unix::Passwd::File's min_new_gid. }
Special arguments:
-tx_action => str
For more information on transaction, see Rinci::Transaction.
-tx_action_id => str
-tx_recovery => str
-tx_rollback => str
-tx_v => str
Returns an enveloped result (an array).
First element (status) is an integer containing HTTP status code (200 means OK, 4xx caller error, 5xx function error). Second element (msg) is a string containing error message, or 'OK' if status is 200. Third element (result) is optional, the actual result. Fourth element (meta) is called result metadata and is optional, a hash that contains extra information.
Return value: (any)
{en_US Delete group}.
{en_US Fixed state: group does not exist.
Fixable state: group exists. }
{en_US Setup Unix group (existence)}.
{en_US On do, will create Unix group if not already exists. The created GID will be returned in the result ({gid => GID}). If should_already_exist is set to true, won't create but only require that group already exists. If should_exist is set to false, will delete existing group instead of creating it.
{gid => GID}
should_already_exist
should_exist
On undo, will delete Unix group previously created.
On redo, will recreate the Unix group with the same GID. }
max_new_gid => int (default: 65534)
min_new_gid => int (default: 1000)
new_gid => int
should_already_exist => bool
{en_US Whether group should already exist}.
should_exist => bool (default: 1)
{en_US Whether group should exist}.
Please visit the project's homepage at https://metacpan.org/release/Setup-Unix-User.
Source repository is at https://github.com/perlancar/perl-Setup-Unix-User.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Setup-Unix-User
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
perlancar <perlancar@cpan.org>
This software is copyright (c) 2015 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Setup::Unix::User, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Setup::Unix::User
CPAN shell
perl -MCPAN -e shell install Setup::Unix::User
For more information on module installation, please visit the detailed CPAN module installation guide.