view release on metacpan or  search on metacpan

script/create-sparse-file  view on Meta::CPAN

use strict;
use warnings;

use Perinci::CmdLine::Any;

Perinci::CmdLine::Any->new(
    url => "/App/CreateSparseFile/create_sparse_file",
    program_name => "create-sparse-file",
)->run;

# ABSTRACT: Create sparse file
# PODNAME: create-sparse-file

__END__

=pod

=encoding UTF-8

=head1 NAME

create-sparse-file - Create sparse file

=head1 VERSION

This document describes version 0.080 of create-sparse-file (from Perl distribution App-CreateSparseFile), released on 2017-11-10.

=head1 SYNOPSIS

Usage:

 % create-sparse-file [options] <name> <size>

Examples:

Create a sparse file called file.bin with size of 30GB:

 % create-sparse-file file.bin 30G

=head1 DESCRIPTION

Sparse file is a file with a predefined size (sometimes large) but does not yet
allocate all its (blank) data on disk. Sparse file is a feature of filesystem.

I usually create sparse file when I want to create a large disk image but do not
want to preallocate its data yet. Creating a sparse file should be virtually
instantaneous.

=head1 OPTIONS

C<*> marks required options.

=head2 Main options

=over

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

=item B<--no-interactive>

If set to false then will not prompt interactively and usually will proceed
(unless for dangerous stuffs, in which case will bail immediately.


=item B<--overwrite>

Whether to overwrite existing file.

If se to true then will overwrite existing file without warning. The default is
to prompt, or bail (if not interactive).


=item B<--size>=I<s>*, B<-s>

Size (e.g. 10K, 22.5M).

=back

=head2 Configuration options

=over

=item B<--config-path>=I<filename>

Set path to configuration file.

Can be specified multiple times.

=item B<--config-profile>=I<s>

Set configuration profile to use.

=item B<--no-config>

Do not use any configuration file.

=back

=head2 Environment options

=over

=item B<--no-env>

Do not read environment for default options.

=back

=head2 Output options

=over

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

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

Default value:

 undef

=item B<--json>

Set output format to json.

=item B<--naked-res>

When outputing as JSON, strip result envelope.

Default value: