=encoding utf8
=head1 NAME
POSIX::1003::Sysconf - POSIX access to sysconf()
=head1 SYNOPSIS
use POSIX::1003::Sysconf; # load all names
use POSIX::1003::Sysconf qw(sysconf);
# keys are strings!
$ticks = sysconf('_SC_CLK_TCK');
use POSIX::1003::Sysconf qw(sysconf _SC_CLK_TCK);
$ticks = _SC_CLK_TCK; # constants are subs
use POSIX::1003::Sysconf '%sysconf';
my $key = $sysconf{_SC_CLK_TCK};
$sysconf{_SC_NEW_KEY} = $key_code;
$ticks = sysconf($key);
print "$_\n" for keys %sysconf;
=head1 DESCRIPTION
The C<sysconf()> interface can be used to query system information
in numerical form, where C<confstr()> returns strings.
=head1 METHODS
=head1 FUNCTIONS
=head2 Standard POSIX
=over 4
=item B<sysconf>($name)
Returns the sysconf value related to the NAMEd constant. The $name
must be a string. C<undef> will be returned when the $name is not
known by the system.
example:
my $ticks = sysconf('_SC_CLK_TCK') || 1000;
=back
=head2 Additional
=over 4
=item B<sysconf_names>()
Returns a list with all known names, unsorted.
=back
=head1 CONSTANTS
=over 4
=item B<%sysconf>
This exported variable is a tied HASH which maps C<_SC_*> names
on unique numbers, to be used with the system's C<sysconf()> function.
=back
The following constants where detected on your system when the
module got installed. The second column shows the value which
where returned at that time.
=for comment
#TABLE_SYSCONF_START
During installation, a symbol table will get inserted here.
=for comment
#TABLE_SYSCONF_END
=head1 SEE ALSO
This module is part of POSIX-1003 distribution version 1.02,
built on November 10, 2020. Website: F<http://perl.overmeer.net/CPAN>. The code is based on L<POSIX>, which
is released with Perl itself. See also L<POSIX::Util> for
additional functionality.
=head1 COPYRIGHTS
Copyrights 2011-2020 on the perl code and the related documentation
by [Mark Overmeer]. For other contributors see ChangeLog.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://dev.perl.org/licenses/>