view release on metacpan or  search on metacpan

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

#!perl

# Note: This script is a CLI for Riap function /Unix/Passwd/File/add_user
# 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_user",
    program_name => "upf-add-user",
    read_config => 0,
    read_env => 0,
);

$cmdline->run;

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

__END__

=pod

=encoding UTF-8

=head1 NAME

upf-add-user - Add a new user

=head1 VERSION

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

=head1 SYNOPSIS

Usage:

 % upf-add-user [--backup] [--encpass=s] [--etc-dir=s] [--expire-date=s]
     [--format=name] [--gecos=s] [--gid=s] [--group=s] [--home=s] [--json]
     [--last-pwchange=s] [--max-gid=s] [--max-pass-age=s] [--max-uid=s]
     [--min-gid=s] [--min-pass-age=s] [--min-uid=s] [--(no)naked-res]
     [--no-backup] [--nobackup] [--page-result[=program]]
     [--pass-inactive-period=s] [--pass-warn-period=s] [--pass=s]
     [--shell=s] [--uid=s] <user>

=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<--encpass>=I<s>

Encrypted password.

=item B<--expire-date>=I<s>

The date of expiration of the account, expressed as the number of days since Jan 1, 1970.

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

Usually, it contains the full username.

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

Pick a specific GID when creating group.

Duplicate GID is allowed.


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

Select primary group (default is group with same name as user).

Normally, a user's primary group with group with the same name as user, which
will be created if does not already exist. You can pick another group here,
which must already exist (and in this case, the group with the same name as user
will not be created).


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

User's home directory.

=item B<--last-pwchange>=I<s>

The date of the last password change, expressed as the number of days since Jan 1, 1970..

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

Pick a range for GID when creating group.

=item B<--max-pass-age>=I<s>

The number of days after which the user will have to change her password.

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

Pick a range for new UID.

Default value:

 65535

If a free UID between `min_uid` and `max_uid` is not found, error 412 is
returned.


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