view release on metacpan or  search on metacpan

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

#!perl

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

$cmdline->run;

# ABSTRACT: Modify an existing user
# PODNAME: upf-modify-user

__END__

=pod

=encoding UTF-8

=head1 NAME

upf-modify-user - Modify an existing user

=head1 VERSION

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

=head1 SYNOPSIS

Usage:

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

=head1 DESCRIPTION

Specify arguments to modify corresponding fields. Unspecified fields will not be
modified.

=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>

Numeric primary group ID for this user.

=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-pass-age>=I<s>

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

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

The number of days the user will have to wait before she will be allowed to change her password again.

=item B<--pass-inactive-period>=I<s>

The number of days after a password has expired (see max_pass_age) during which the password should still be accepted (and user should update her password during the next login).

=item B<--pass-warn-period>=I<s>

The number of days before a password is going to expire (see max_pass_age) during which the user should be warned.

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

User's shell.

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

Numeric user ID.

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

User (login) name.

=back

=head2 Output options

=over