=encoding utf8
=head1 NAME
POSIX::1003::Confstr - POSIX access to confstr()
=head1 SYNOPSIS
use POSIX::1003::Confstr; # import all
use POSIX::1003::Confstr 'confstr';
my $path = confstr('_CS_PATH');
use POSIX::1003::Confstr '_CS_PATH';
my $path = _CS_PATH;
use POSIX::1003::Confstr '%confstr';
my $key = $confstr{_CS_PATH};
$confstr{_CS_NEW_CONF} = $key;
=head1 DESCRIPTION
With C<confstr()> you can retreive string values from the operating
system. It is the counterpart of C<sysconf()> which can only return
numeric values.
=head1 METHODS
=head1 FUNCTIONS
=head2 Standard POSIX
=over 4
=item B<confstr>(NAME)
Returns the confstr 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 $path = confstr('_CS_PATH') || '/bin:/usr/bin';
=back
=head2 Additional
=over 4
=item B<confstr_names>()
Returns a list with all known names, unsorted.
=back
=head1 CONSTANTS
=over 4
=item B<%confstr>
This exported variable is a (tied) HASH which maps C<_CS_*>
names to the unique numbers to be used with the system's C<confstr()>
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_CONFSTR_START
_CS_GNU_LIBC_VERSION 'glibc 2.15'
_CS_GNU_LIBPTHREAD_VERSION 'NPTL 2.15'
_CS_LFS64_CFLAGS '-D_LARGEFILE64_SOURCE'
_CS_LFS64_LDFLAGS ''
_CS_LFS64_LIBS ''
_CS_LFS64_LINTFLAGS '-D_LARGEFILE64_SOURCE'
_CS_LFS_CFLAGS ''
_CS_LFS_LDFLAGS ''
_CS_LFS_LIBS ''
_CS_LFS_LINTFLAGS ''
_CS_PATH '/bin:/usr/bin'
_CS_POSIX_V5_WIDTH_RESTRICTED_ENVS 'XBS5_LP64_OFF64'
_CS_POSIX_V6_ILP32_OFF32_CFLAGS ''
_CS_POSIX_V6_ILP32_OFF32_LDFLAGS ''
_CS_POSIX_V6_ILP32_OFF32_LIBS ''
_CS_POSIX_V6_ILP32_OFF32_LINTFLAGS ''
_CS_POSIX_V6_ILP32_OFFBIG_CFLAGS ''
_CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS ''
_CS_POSIX_V6_ILP32_OFFBIG_LIBS ''
_CS_POSIX_V6_ILP32_OFFBIG_LINTFLAGS ''
_CS_POSIX_V6_LP64_OFF64_CFLAGS '-m64'
_CS_POSIX_V6_LP64_OFF64_LDFLAGS '-m64'
_CS_POSIX_V6_LP64_OFF64_LIBS ''
_CS_POSIX_V6_LP64_OFF64_LINTFLAGS ''
_CS_POSIX_V6_LPBIG_OFFBIG_CFLAGS ''
_CS_POSIX_V6_LPBIG_OFFBIG_LDFLAGS ''
_CS_POSIX_V6_LPBIG_OFFBIG_LIBS ''
_CS_POSIX_V6_LPBIG_OFFBIG_LINTFLAGS ''
_CS_POSIX_V6_WIDTH_RESTRICTED_ENVS 'POSIX_V6_LP64_OFF64'
_CS_POSIX_V7_ILP32_OFF32_CFLAGS ''
_CS_POSIX_V7_ILP32_OFF32_LDFLAGS ''
_CS_POSIX_V7_ILP32_OFF32_LIBS ''
_CS_POSIX_V7_ILP32_OFF32_LINTFLAGS ''
_CS_POSIX_V7_ILP32_OFFBIG_CFLAGS ''
_CS_POSIX_V7_ILP32_OFFBIG_LDFLAGS ''
_CS_POSIX_V7_ILP32_OFFBIG_LIBS ''
_CS_POSIX_V7_ILP32_OFFBIG_LINTFLAGS ''
_CS_POSIX_V7_LP64_OFF64_CFLAGS '-m64'
_CS_POSIX_V7_LP64_OFF64_LDFLAGS '-m64'
_CS_POSIX_V7_LP64_OFF64_LIBS ''
_CS_POSIX_V7_LP64_OFF64_LINTFLAGS ''
_CS_POSIX_V7_LPBIG_OFFBIG_CFLAGS ''
_CS_POSIX_V7_LPBIG_OFFBIG_LDFLAGS ''
_CS_POSIX_V7_LPBIG_OFFBIG_LIBS ''
_CS_POSIX_V7_LPBIG_OFFBIG_LINTFLAGS ''
_CS_POSIX_V7_WIDTH_RESTRICTED_ENVS 'POSIX_V7_LP64_OFF64'
_CS_V5_WIDTH_RESTRICTED_ENVS 'XBS5_LP64_OFF64'
_CS_V6_WIDTH_RESTRICTED_ENVS 'POSIX_V6_LP64_OFF64'
_CS_V7_WIDTH_RESTRICTED_ENVS 'POSIX_V7_LP64_OFF64'
_CS_XBS5_ILP32_OFF32_CFLAGS ''
_CS_XBS5_ILP32_OFF32_LDFLAGS ''
_CS_XBS5_ILP32_OFF32_LIBS ''
_CS_XBS5_ILP32_OFF32_LINTFLAGS ''
_CS_XBS5_ILP32_OFFBIG_CFLAGS ''
_CS_XBS5_ILP32_OFFBIG_LDFLAGS ''
_CS_XBS5_ILP32_OFFBIG_LIBS ''
_CS_XBS5_ILP32_OFFBIG_LINTFLAGS ''
_CS_XBS5_LP64_OFF64_CFLAGS '-m64'
_CS_XBS5_LP64_OFF64_LDFLAGS '-m64'
_CS_XBS5_LP64_OFF64_LIBS ''
_CS_XBS5_LP64_OFF64_LINTFLAGS ''
_CS_XBS5_LPBIG_OFFBIG_CFLAGS ''
_CS_XBS5_LPBIG_OFFBIG_LDFLAGS ''
_CS_XBS5_LPBIG_OFFBIG_LIBS ''
_CS_XBS5_LPBIG_OFFBIG_LINTFLAGS ''
=for comment
#TABLE_CONFSTR_END
=head1 SEE ALSO
This module is part of POSIX-1003 distribution version 0.94_1,
built on May 16, 2013. Website: F<http://perl.overmeer.net>. 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-2013 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://www.perl.com/perl/misc/Artistic.html>