view release on metacpan or  search on metacpan

script/upf-add-group  view on Meta::CPAN

#!perl

# Note: This script is a CLI for Riap function /Unix/Passwd/File/add_group
# and generated automatically using Perinci::CmdLine::Gen version 0.496

our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY
our $DATE = '2020-04-29'; # DATE
our $DIST = 'App-UpfUtils'; # DIST
our $VERSION = '0.060'; # VERSION

use 5.010001;
use strict;
use warnings;

use Perinci::CmdLine::Any;

my $cmdline = Perinci::CmdLine::Any->new(
    url => "/Unix/Passwd/File/add_group",
    program_name => "upf-add-group",
    read_config => 0,
    read_env => 0,
);

$cmdline->run;

# ABSTRACT: Add a new group
# PODNAME: upf-add-group

__END__

=pod

=encoding UTF-8

=head1 NAME

upf-add-group - Add a new group

=head1 VERSION

This document describes version 0.060 of upf-add-group (from Perl distribution App-UpfUtils), released on 2020-04-29.

=head1 SYNOPSIS

Usage:

 % upf-add-group [--backup] [--etc-dir=s] [--format=name] [--gid=s]
     [--json] [--max-gid=s] [--members-json=s] [--members=s] [--min-gid=s]
     [--(no)naked-res] [--no-backup] [--nobackup] [--page-result[=program]]
     <group>

=head1 OPTIONS

C<*> marks required options.

=head2 Main options

=over

=item B<--backup>

Whether to backup when modifying files.

Backup is written with `.bak` extension in the same directory. Unmodified file
will not be backed up. Previous backup will be overwritten.


=item B<--gid>=I<s>

Pick a specific new GID.

Adding a new group with duplicate GID is allowed.


=item B<--group>=I<s>*

=item B<--max-gid>=I<s>

Pick a range for new GID.

Default value:

 65535

If a free GID between `min_gid` and `max_gid` is not found, error 412 is
returned.


=item B<--members-json>=I<s>

Fill initial members (JSON-encoded).

See C<--members>.

=item B<--members>=I<s>

Fill initial members.

=item B<--min-gid>=I<s>

Pick a range for new GID.

Default value:

 1000

If a free GID between `min_gid` and `max_gid` is not found, error 412 is
returned.


=back

=head2 Output options

=over

=item B<--format>=I<s>

Choose output format, e.g. json, text.

Default value:

 undef

=item B<--json>