home *** CD-ROM | disk | FTP | other *** search
/ Chip: Linux Special / CorelLinux_CHIP.iso / live / usr / lib / perl5 / i386-linux / 5.004 / Config.pm next >
Encoding:
Perl POD Document  |  1999-02-03  |  16.0 KB  |  744 lines
  1. package Config;
  2. use Exporter ();
  3. @ISA = (Exporter);
  4. @EXPORT = qw(%Config);
  5. @EXPORT_OK = qw(myconfig config_sh config_vars);
  6.  
  7. $] == 5.00404
  8.   or die "Perl lib version (5.00404) doesn't match executable version ($])";
  9.  
  10. # This file was created by configpm when Perl was built. Any changes
  11. # made to this file will be lost the next time perl is built.
  12.  
  13. ##
  14. ## This file was produced by running the Configure script.  It holds all
  15. ## the definitions figured out by Configure.  Should you modify any of
  16. ## these values, do not forget to propagate your changes by running
  17. ## "Configure -S"; or, equivalently, you may run each .SH file yourself.
  18. ##
  19. #
  20. ## Configuration time: Wed Feb  3 00:50:04 PST 1999
  21. ## Configured by: torin
  22. ## Target system: linux perv 2.0.36 #2 wed nov 18 03:00:48 pst 1998 i686 unknown 
  23. #
  24.  
  25. my $config_sh = <<'!END!';
  26. archlibexp='/usr/lib/perl5/i386-linux/5.004'
  27. archname='i386-linux'
  28. cc='cc'
  29. ccflags='-Dbool=char -DHAS_BOOL -D_REENTRANT'
  30. cppflags='-Dbool=char -DHAS_BOOL -D_REENTRANT'
  31. dlsrc='dl_dlopen.xs'
  32. dynamic_ext='DB_File Fcntl GDBM_File IO NDBM_File ODBM_File Opcode POSIX SDBM_File Socket'
  33. extensions='DB_File Fcntl GDBM_File IO NDBM_File ODBM_File Opcode POSIX SDBM_File Socket'
  34. installarchlib='/usr/lib/perl5/i386-linux/5.004'
  35. installprivlib='/usr/lib/perl5'
  36. libpth='/usr/local/lib /lib /usr/lib'
  37. libs='-lnsl -lndbm -lgdbm -ldbm -ldb -ldl -lm -lc -lposix -lcrypt'
  38. osname='linux'
  39. osvers='2.0.36'
  40. prefix='/usr'
  41. privlibexp='/usr/lib/perl5'
  42. sharpbang='#!'
  43. shsharp='true'
  44. sig_name='ZERO HUP INT QUIT ILL TRAP ABRT BUS FPE KILL USR1 SEGV USR2 PIPE ALRM TERM STKFLT CHLD CONT STOP TSTP TTIN TTOU URG XCPU XFSZ VTALRM PROF WINCH IO PWR UNUSED IOT CLD POLL '
  45. sig_num='0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 6 17 29 '
  46. so='so'
  47. startsh='#!/bin/sh'
  48. static_ext=' '
  49. Author=''
  50. CONFIG='true'
  51. Date='$Date'
  52. Header=''
  53. Id='$Id'
  54. Locker=''
  55. Log='$Log'
  56. Mcc='Mcc'
  57. PATCHLEVEL='4'
  58. RCSfile='$RCSfile'
  59. Revision='$Revision'
  60. SUBVERSION='4'
  61. Source=''
  62. State=''
  63. afs='false'
  64. alignbytes='4'
  65. aphostname=''
  66. ar='ar'
  67. archlib='/usr/lib/perl5/i386-linux/5.004'
  68. archobjs=''
  69. awk='awk'
  70. baserev='5.0'
  71. bash=''
  72. bin='/usr/bin'
  73. bincompat3='n'
  74. binexp='/usr/bin'
  75. bison=''
  76. byacc='byacc'
  77. byteorder='1234'
  78. c=''
  79. castflags='0'
  80. cat='cat'
  81. cccdlflags='-fpic'
  82. ccdlflags='-rdynamic'
  83. cf_by='torin'
  84. cf_email='torin@perv.daft.com'
  85. cf_time='Wed Feb  3 00:50:04 PST 1999'
  86. chgrp=''
  87. chmod=''
  88. chown=''
  89. clocktype='clock_t'
  90. comm='comm'
  91. compress=''
  92. contains='grep'
  93. cp='cp'
  94. cpio=''
  95. cpp='cpp'
  96. cpp_stuff='42'
  97. cpplast='-'
  98. cppminus='-'
  99. cpprun='cc -E'
  100. cppstdin='cc -E'
  101. cryptlib=''
  102. csh='csh'
  103. d_Gconvert='gcvt((x),(n),(b))'
  104. d_access='define'
  105. d_alarm='define'
  106. d_archlib='define'
  107. d_attribut='define'
  108. d_bcmp='define'
  109. d_bcopy='define'
  110. d_bincompat3='undef'
  111. d_bsd='undef'
  112. d_bsdgetpgrp='undef'
  113. d_bsdpgrp='undef'
  114. d_bsdsetpgrp='undef'
  115. d_bzero='define'
  116. d_casti32='define'
  117. d_castneg='define'
  118. d_charvspr='undef'
  119. d_chown='define'
  120. d_chroot='define'
  121. d_chsize='undef'
  122. d_closedir='define'
  123. d_const='define'
  124. d_crypt='define'
  125. d_csh='undef'
  126. d_cuserid='define'
  127. d_dbl_dig='define'
  128. d_difftime='define'
  129. d_dirnamlen='undef'
  130. d_dlerror='define'
  131. d_dlopen='define'
  132. d_dlsymun='undef'
  133. d_dosuid='define'
  134. d_dup2='define'
  135. d_eofnblk='define'
  136. d_eunice='undef'
  137. d_fchmod='define'
  138. d_fchown='define'
  139. d_fcntl='define'
  140. d_fd_macros='define'
  141. d_fd_set='define'
  142. d_fds_bits='define'
  143. d_fgetpos='define'
  144. d_flexfnam='define'
  145. d_flock='define'
  146. d_fork='define'
  147. d_fpathconf='define'
  148. d_fsetpos='define'
  149. d_fstatfs='define'
  150. d_fstatvfs='undef'
  151. d_ftime='undef'
  152. d_getgrps='define'
  153. d_gethent='define'
  154. d_gethname='undef'
  155. d_getlogin='define'
  156. d_getmntent='define'
  157. d_getpgid='define'
  158. d_getpgrp2='undef'
  159. d_getpgrp='define'
  160. d_getppid='define'
  161. d_getprior='define'
  162. d_gettimeod='define'
  163. d_gnulibc='define'
  164. d_hasmntopt='define'
  165. d_htonl='define'
  166. d_index='undef'
  167. d_inetaton='define'
  168. d_isascii='define'
  169. d_killpg='define'
  170. d_link='define'
  171. d_locconv='define'
  172. d_lockf='define'
  173. d_lstat='define'
  174. d_mblen='define'
  175. d_mbstowcs='define'
  176. d_mbtowc='define'
  177. d_memcmp='define'
  178. d_memcpy='define'
  179. d_memmove='define'
  180. d_memset='define'
  181. d_mkdir='define'
  182. d_mkfifo='define'
  183. d_mktime='define'
  184. d_msg='define'
  185. d_msgctl='define'
  186. d_msgget='define'
  187. d_msgrcv='define'
  188. d_msgsnd='define'
  189. d_mymalloc='undef'
  190. d_nice='define'
  191. d_oldarchlib='undef'
  192. d_oldsock='undef'
  193. d_open3='define'
  194. d_pathconf='define'
  195. d_pause='define'
  196. d_phostname='undef'
  197. d_pipe='define'
  198. d_poll='define'
  199. d_portable='define'
  200. d_pwage='undef'
  201. d_pwchange='undef'
  202. d_pwclass='undef'
  203. d_pwcomment='undef'
  204. d_pwexpire='undef'
  205. d_pwquota='undef'
  206. d_readdir='define'
  207. d_readlink='define'
  208. d_rename='define'
  209. d_rewinddir='define'
  210. d_rmdir='define'
  211. d_safebcpy='define'
  212. d_safemcpy='undef'
  213. d_sanemcmp='define'
  214. d_seekdir='define'
  215. d_select='define'
  216. d_sem='define'
  217. d_semctl='define'
  218. d_semget='define'
  219. d_semop='define'
  220. d_setegid='define'
  221. d_seteuid='define'
  222. d_setgrps='define'
  223. d_setlinebuf='define'
  224. d_setlocale='define'
  225. d_setpgid='define'
  226. d_setpgrp2='undef'
  227. d_setpgrp='define'
  228. d_setprior='define'
  229. d_setregid='define'
  230. d_setresgid='undef'
  231. d_setresuid='undef'
  232. d_setreuid='define'
  233. d_setrgid='undef'
  234. d_setruid='undef'
  235. d_setsid='define'
  236. d_sfio='undef'
  237. d_shm='define'
  238. d_shmat='define'
  239. d_shmatprototype='define'
  240. d_shmctl='define'
  241. d_shmdt='define'
  242. d_shmget='define'
  243. d_sigaction='define'
  244. d_sigsetjmp='define'
  245. d_socket='define'
  246. d_sockpair='define'
  247. d_statblks='undef'
  248. d_statfsflags='undef'
  249. d_stdio_cnt_lval='undef'
  250. d_stdio_ptr_lval='define'
  251. d_stdiobase='define'
  252. d_stdstdio='define'
  253. d_strchr='define'
  254. d_strcoll='define'
  255. d_strctcpy='define'
  256. d_strerrm='strerror(e)'
  257. d_strerror='define'
  258. d_strtod='define'
  259. d_strtol='define'
  260. d_strtoul='define'
  261. d_strxfrm='define'
  262. d_suidsafe='undef'
  263. d_symlink='define'
  264. d_syscall='define'
  265. d_sysconf='define'
  266. d_sysernlst=''
  267. d_syserrlst='define'
  268. d_system='define'
  269. d_tcgetpgrp='define'
  270. d_tcsetpgrp='define'
  271. d_telldir='define'
  272. d_time='define'
  273. d_times='define'
  274. d_truncate='define'
  275. d_tzname='define'
  276. d_umask='define'
  277. d_uname='define'
  278. d_vfork='undef'
  279. d_void_closedir='undef'
  280. d_voidsig='define'
  281. d_voidtty=''
  282. d_volatile='define'
  283. d_vprintf='define'
  284. d_wait4='define'
  285. d_waitpid='define'
  286. d_wcstombs='define'
  287. d_wctomb='define'
  288. d_xenix='undef'
  289. date='date'
  290. db_hashtype='u_int32_t'
  291. db_prefixtype='size_t'
  292. defvoidused='15'
  293. direntrytype='struct dirent'
  294. dlext='so'
  295. eagain='EAGAIN'
  296. echo='echo'
  297. egrep='egrep'
  298. emacs=''
  299. eunicefix=':'
  300. exe_ext=''
  301. expr='expr'
  302. find='find'
  303. firstmakefile='makefile'
  304. flex=''
  305. fpostype='fpos_t'
  306. freetype='void'
  307. full_csh='/bin/csh'
  308. full_sed='/bin/sed'
  309. gcc=''
  310. gccversion='2.7.2.3'
  311. gidtype='gid_t'
  312. glibpth='/usr/shlib  /shlib /usr/lib/pa1.1 /usr/lib/large /lib /usr/lib /usr/lib/386 /lib/386 /lib/large /usr/lib/small /lib/small /usr/ccs/lib /usr/ucblib /usr/local/lib '
  313. grep='grep'
  314. groupcat=''
  315. groupstype='gid_t'
  316. gzip='gzip'
  317. h_fcntl='false'
  318. h_sysfile='true'
  319. hint='recommended'
  320. hostcat=''
  321. huge=''
  322. i_bsdioctl=''
  323. i_db='define'
  324. i_dbm='define'
  325. i_dirent='define'
  326. i_dld='undef'
  327. i_dlfcn='define'
  328. i_fcntl='undef'
  329. i_float='define'
  330. i_gdbm='define'
  331. i_grp='define'
  332. i_limits='define'
  333. i_locale='define'
  334. i_malloc='define'
  335. i_math='define'
  336. i_memory='undef'
  337. i_mntent='define'
  338. i_ndbm='define'
  339. i_neterrno='undef'
  340. i_niin='define'
  341. i_pwd='define'
  342. i_rpcsvcdbm='undef'
  343. i_sfio='undef'
  344. i_sgtty='undef'
  345. i_shadow='define'
  346. i_stdarg='define'
  347. i_stddef='define'
  348. i_stdlib='define'
  349. i_string='define'
  350. i_sysdir='define'
  351. i_sysfile='define'
  352. i_sysfilio='undef'
  353. i_sysin='undef'
  354. i_sysioctl='define'
  355. i_sysmount='define'
  356. i_sysndir='undef'
  357. i_sysparam='define'
  358. i_sysresrc='define'
  359. i_sysselct='define'
  360. i_syssockio=''
  361. i_sysstat='define'
  362. i_sysstatvfs='undef'
  363. i_systime='define'
  364. i_systimek='undef'
  365. i_systimes='define'
  366. i_systypes='define'
  367. i_sysun='define'
  368. i_syswait='define'
  369. i_termio='undef'
  370. i_termios='define'
  371. i_time='undef'
  372. i_unistd='define'
  373. i_utime='define'
  374. i_values='define'
  375. i_varargs='undef'
  376. i_varhdr='stdarg.h'
  377. i_vfork='undef'
  378. incpath=''
  379. inews=''
  380. installbin='/usr/bin'
  381. installman1dir='/usr/man/man1'
  382. installman3dir='/usr/man/man3'
  383. installscript='/usr/bin'
  384. installsitearch='/usr/local/lib/site_perl/i386-linux'
  385. installsitelib='/usr/local/lib/site_perl'
  386. intsize='4'
  387. known_extensions='DB_File Fcntl GDBM_File IO NDBM_File ODBM_File Opcode POSIX SDBM_File Socket'
  388. ksh=''
  389. large=''
  390. ld='cc'
  391. lddlflags='-shared -L/usr/local/lib'
  392. ldflags=' -L/usr/local/lib'
  393. less='less'
  394. lib_ext='.a'
  395. libc=''
  396. libperl='libperl.a'
  397. libswanted='sfio net socket inet nsl nm ndbm gdbm dbm db malloc dl dld ld sun m c cposix posix ndir dir crypt ucb BSD PW x'
  398. line='line'
  399. lint=''
  400. lkflags=''
  401. ln='ln'
  402. lns='/bin/ln -s'
  403. locincpth='/usr/local/include /opt/local/include /usr/gnu/include /opt/gnu/include /usr/GNU/include /opt/GNU/include'
  404. loclibpth='/usr/local/lib /opt/local/lib /usr/gnu/lib /opt/gnu/lib /usr/GNU/lib /opt/GNU/lib'
  405. longsize='4'
  406. lp=''
  407. lpr=''
  408. ls='ls'
  409. lseektype='off_t'
  410. mail=''
  411. mailx=''
  412. make='/usr/bin/make'
  413. make_set_make='#'
  414. mallocobj=''
  415. mallocsrc=''
  416. malloctype='void *'
  417. man1dir='/usr/man/man1'
  418. man1direxp='/usr/man/man1'
  419. man1ext='1p'
  420. man3dir='/usr/man/man3'
  421. man3direxp='/usr/man/man3'
  422. man3ext='3pm'
  423. medium=''
  424. mips=''
  425. mips_type=''
  426. mkdir='mkdir'
  427. models='none'
  428. modetype='mode_t'
  429. more='more'
  430. mv=''
  431. myarchname='i686-linux'
  432. mydomain='.daft.com'
  433. myhostname='perv'
  434. myuname='linux perv 2.0.36 #2 wed nov 18 03:00:48 pst 1998 i686 unknown '
  435. n='-n'
  436. nm_opt=''
  437. nm_so_opt='--dynamic'
  438. nroff='nroff'
  439. o_nonblock='O_NONBLOCK'
  440. obj_ext='.o'
  441. oldarchlib=''
  442. oldarchlibexp=''
  443. optimize='-O2'
  444. orderlib='false'
  445. package='perl5'
  446. pager='/usr/bin/less'
  447. passcat=''
  448. patchlevel='4'
  449. path_sep=':'
  450. perl='perl'
  451. perladmin='none'
  452. perlpath='/usr/bin/perl'
  453. pg='pg'
  454. phostname='hostname'
  455. plibpth=''
  456. pmake=''
  457. pr=''
  458. prefixexp='/usr'
  459. privlib='/usr/lib/perl5'
  460. prototype='define'
  461. randbits='31'
  462. ranlib=':'
  463. rd_nodata='-1'
  464. rm='rm'
  465. rmail=''
  466. runnm='false'
  467. scriptdir='/usr/bin'
  468. scriptdirexp='/usr/bin'
  469. sed='sed'
  470. selecttype='fd_set *'
  471. sendmail='sendmail'
  472. sh='/bin/sh'
  473. shar=''
  474. shmattype='void *'
  475. shortsize='2'
  476. shrpenv=''
  477. signal_t='void'
  478. sitearch='/usr/local/lib/site_perl/i386-linux'
  479. sitearchexp='/usr/local/lib/site_perl/i386-linux'
  480. sitelib='/usr/local/lib/site_perl'
  481. sitelibexp='/usr/local/lib/site_perl'
  482. sizetype='size_t'
  483. sleep=''
  484. smail=''
  485. small=''
  486. sockethdr=''
  487. socketlib=''
  488. sort='sort'
  489. spackage='Perl5'
  490. spitshell='cat'
  491. split=''
  492. ssizetype='ssize_t'
  493. startperl='#!/usr/bin/perl'
  494. stdchar='char'
  495. stdio_base='((fp)->_IO_read_base)'
  496. stdio_bufsiz='((fp)->_IO_read_end - (fp)->_IO_read_base)'
  497. stdio_cnt='((fp)->_IO_read_end - (fp)->_IO_read_ptr)'
  498. stdio_ptr='((fp)->_IO_read_ptr)'
  499. strings='/usr/include/string.h'
  500. submit=''
  501. subversion='4'
  502. sysman='/usr/man/man1'
  503. tail=''
  504. tar=''
  505. tbl=''
  506. test='test'
  507. timeincl='/usr/include/sys/time.h '
  508. timetype='time_t'
  509. touch='touch'
  510. tr='tr'
  511. troff=''
  512. uidtype='uid_t'
  513. uname='uname'
  514. uniq='uniq'
  515. usedl='define'
  516. usemymalloc='n'
  517. usenm='false'
  518. useopcode='true'
  519. useperlio='undef'
  520. useposix='true'
  521. usesfio='false'
  522. useshrplib='false'
  523. usevfork='false'
  524. usrinc='/usr/include'
  525. uuname=''
  526. vi=''
  527. voidflags='15'
  528. xlibpth='/usr/lib/386 /lib/386'
  529. zcat=''
  530. zip='zip'
  531. !END!
  532.  
  533. my $summary = <<'!END!';
  534. Summary of my $package ($baserev patchlevel $PATCHLEVEL subversion $SUBVERSION) configuration:
  535.   Platform:
  536.     osname=$osname, osvers=$osvers, archname=$archname
  537.     uname='$myuname'
  538.     hint=$hint, useposix=$useposix, d_sigaction=$d_sigaction
  539.     bincompat3=$bincompat3 useperlio=$useperlio d_sfio=$d_sfio
  540.   Compiler:
  541.     cc='$cc', optimize='$optimize', gccversion=$gccversion
  542.     cppflags='$cppflags'
  543.     ccflags ='$ccflags'
  544.     stdchar='$stdchar', d_stdstdio=$d_stdstdio, usevfork=$usevfork
  545.     voidflags=$voidflags, castflags=$castflags, d_casti32=$d_casti32, d_castneg=$d_castneg
  546.     intsize=$intsize, alignbytes=$alignbytes, usemymalloc=$usemymalloc, prototype=$prototype
  547.   Linker and Libraries:
  548.     ld='$ld', ldflags ='$ldflags'
  549.     libpth=$libpth
  550.     libs=$libs
  551.     libc=$libc, so=$so
  552.     useshrplib=$useshrplib, libperl=$libperl
  553.   Dynamic Linking:
  554.     dlsrc=$dlsrc, dlext=$dlext, d_dlsymun=$d_dlsymun, ccdlflags='$ccdlflags'
  555.     cccdlflags='$cccdlflags', lddlflags='$lddlflags'
  556.  
  557. !END!
  558. my $summary_expanded = 0;
  559.  
  560. sub myconfig {
  561.     return $summary if $summary_expanded;
  562.     $summary =~ s{\$(\w+)}
  563.              { my $c = $Config{$1}; defined($c) ? $c : 'undef' }ge;
  564.     $summary_expanded = 1;
  565.     $summary;
  566. }
  567.  
  568. sub FETCH { 
  569.     # check for cached value (which may be undef so we use exists not defined)
  570.     return $_[0]->{$_[1]} if (exists $_[0]->{$_[1]});
  571.  
  572.     # Search for it in the big string 
  573.     my($value, $start, $marker);
  574.     $marker = "$_[1]='";
  575.     # return undef unless (($value) = $config_sh =~ m/^$_[1]='(.*)'\s*$/m);
  576.     $start = index($config_sh, "\n$marker");
  577.     return undef if ( ($start == -1) &&  # in case it's first 
  578.         (substr($config_sh, 0, length($marker)) ne $marker) );
  579.     if ($start == -1) { $start = length($marker) } 
  580.         else { $start += length($marker) + 1 }
  581.     $value = substr($config_sh, $start, 
  582.         index($config_sh, qq('\n), $start) - $start);
  583.  
  584.     $value = undef if $value eq 'undef'; # So we can say "if $Config{'foo'}".
  585.     $_[0]->{$_[1]} = $value; # cache it
  586.     return $value;
  587. }
  588.  
  589. my $prevpos = 0;
  590.  
  591. sub FIRSTKEY {
  592.     $prevpos = 0;
  593.     # my($key) = $config_sh =~ m/^(.*?)=/;
  594.     substr($config_sh, 0, index($config_sh, '=') );
  595.     # $key;
  596. }
  597.  
  598. sub NEXTKEY {
  599.     my $pos = index($config_sh, qq('\n), $prevpos) + 2;
  600.     my $len = index($config_sh, "=", $pos) - $pos;
  601.     $prevpos = $pos;
  602.     $len > 0 ? substr($config_sh, $pos, $len) : undef;
  603. }
  604.  
  605. sub EXISTS { 
  606.     # exists($_[0]->{$_[1]})  or  $config_sh =~ m/^$_[1]=/m;
  607.     exists($_[0]->{$_[1]}) or
  608.     index($config_sh, "\n$_[1]='") != -1 or
  609.     substr($config_sh, 0, length($_[1])+2) eq "$_[1]='";
  610. }
  611.  
  612. sub STORE  { die "\%Config::Config is read-only\n" }
  613. sub DELETE { &STORE }
  614. sub CLEAR  { &STORE }
  615.  
  616.  
  617. sub config_sh {
  618.     $config_sh
  619. }
  620.  
  621. sub config_re {
  622.     my $re = shift;
  623.     my @matches = ($config_sh =~ /^$re=.*\n/mg);
  624.     @matches ? (print @matches) : print "$re: not found\n";
  625. }
  626.  
  627. sub config_vars {
  628.     foreach(@_){
  629.     config_re($_), next if /\W/;
  630.     my $v=(exists $Config{$_}) ? $Config{$_} : 'UNKNOWN';
  631.     $v='undef' unless defined $v;
  632.     print "$_='$v';\n";
  633.     }
  634. }
  635.  
  636. sub TIEHASH { bless {} }
  637.  
  638. # avoid Config..Exporter..UNIVERSAL search for DESTROY then AUTOLOAD
  639. sub DESTROY { }
  640.  
  641. tie %Config, 'Config';
  642.  
  643. 1;
  644. __END__
  645.  
  646. =head1 NAME
  647.  
  648. Config - access Perl configuration information
  649.  
  650. =head1 SYNOPSIS
  651.  
  652.     use Config;
  653.     if ($Config{'cc'} =~ /gcc/) {
  654.     print "built by gcc\n";
  655.     } 
  656.  
  657.     use Config qw(myconfig config_sh config_vars);
  658.  
  659.     print myconfig();
  660.  
  661.     print config_sh();
  662.  
  663.     config_vars(qw(osname archname));
  664.  
  665.  
  666. =head1 DESCRIPTION
  667.  
  668. The Config module contains all the information that was available to
  669. the C<Configure> program at Perl build time (over 900 values).
  670.  
  671. Shell variables from the F<config.sh> file (written by Configure) are
  672. stored in the readonly-variable C<%Config>, indexed by their names.
  673.  
  674. Values stored in config.sh as 'undef' are returned as undefined
  675. values.  The perl C<exists> function can be used to check if a
  676. named variable exists.
  677.  
  678. =over 4
  679.  
  680. =item myconfig()
  681.  
  682. Returns a textual summary of the major perl configuration values.
  683. See also C<-V> in L<perlrun/Switches>.
  684.  
  685. =item config_sh()
  686.  
  687. Returns the entire perl configuration information in the form of the
  688. original config.sh shell variable assignment script.
  689.  
  690. =item config_vars(@names)
  691.  
  692. Prints to STDOUT the values of the named configuration variable. Each is
  693. printed on a separate line in the form:
  694.  
  695.   name='value';
  696.  
  697. Names which are unknown are output as C<name='UNKNOWN';>.
  698. See also C<-V:name> in L<perlrun/Switches>.
  699.  
  700. =back
  701.  
  702. =head1 EXAMPLE
  703.  
  704. Here's a more sophisticated example of using %Config:
  705.  
  706.     use Config;
  707.     use strict;
  708.  
  709.     my %sig_num;
  710.     my @sig_name;
  711.     unless($Config{sig_name} && $Config{sig_num}) {
  712.     die "No sigs?";
  713.     } else {
  714.     my @names = split ' ', $Config{sig_name};
  715.     @sig_num{@names} = split ' ', $Config{sig_num};
  716.     foreach (@names) {
  717.         $sig_name[$sig_num{$_}] ||= $_;
  718.     }   
  719.     }
  720.  
  721.     print "signal #17 = $sig_name[17]\n";
  722.     if ($sig_num{ALRM}) { 
  723.     print "SIGALRM is $sig_num{ALRM}\n";
  724.     }   
  725.  
  726. =head1 WARNING
  727.  
  728. Because this information is not stored within the perl executable
  729. itself it is possible (but unlikely) that the information does not
  730. relate to the actual perl binary which is being used to access it.
  731.  
  732. The Config module is installed into the architecture and version
  733. specific library directory ($Config{installarchlib}) and it checks the
  734. perl version number when loaded.
  735.  
  736. =head1 NOTE
  737.  
  738. This module contains a good example of how to use tie to implement a
  739. cache and an example of how to make a tied variable readonly to those
  740. outside of it.
  741.  
  742. =cut
  743.  
  744.