Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
h2ph(1)
Edit
PageHistory
Diff
Info
LikePages
H2PH !!!H2PH NAME SYNOPSIS DESCRIPTION OPTIONS ENVIRONMENT FILES AUTHOR SEE ALSO DIAGNOSTICS BUGS ---- !!NAME h2ph - convert .h C header files to .ph Perl header files !!SYNOPSIS __h2ph [[-d destination directory] [[-r -a] [[-l] [[headerfiles]__ !!DESCRIPTION ''h2ph'' converts any C header files specified to the corresponding Perl header file format. It is most easily run while in /usr/include: cd /usr/include; h2ph * sys/* or cd /usr/include; h2ph -r -l . The output files are placed in the hierarchy rooted at Perl's architecture dependent library directory. You can specify a different hierarchy with a __-d__ switch. If run with no arguments, filters standard input to standard output. !!OPTIONS -d destination_dir Put the resulting __.ph__ files beneath __destination_dir__, instead of beneath the default Perl library location ($Config{'installsitsearch'}). -r Run recursively; if any of __headerfiles__ are directories, then run ''h2ph'' on all files in those directories (and their subdirectories, etc.). __-r__ and __-a__ are mutually exclusive. -a Run automagically; convert __headerfiles__, as well as any __.h__ files which they include. This option will search for __.h__ files in all directories which your C compiler ordinarily uses. __-a__ and __-r__ are mutually exclusive. -l Symbolic links will be replicated in the destination directory. If __-l__ is not specified, then links are skipped over. -h Put ``hints'' in the .ph files which will help in locating problems with ''h2ph''. In those cases when you __require__ a __.ph__ file containing syntax errors, instead of the cryptic [[ some error condition ] at (eval mmm) line nnn you will see the slightly more helpful [[ some error condition ] at filename.ph line nnn However, the __.ph__ files almost double in size when built using __-h__. -D Include the code from the __.h__ file as a comment in the __.ph__ file. This is primarily used for debugging ''h2ph''. -Q ``Quiet'' mode; don't print out the names of the files being converted. !!ENVIRONMENT No environment variables are used. !!FILES /usr/include/*.h /usr/include/sys/*.h etc. !!AUTHOR Larry Wall !!SEE ALSO perl(1) !!DIAGNOSTICS The usual warnings if it can't read or write the files involved. !!BUGS Doesn't construct the %sizeof array for you. It doesn't handle all C constructs, but it does attempt to isolate definitions inside evals so that you can get at the definitions that it can translate. It's only intended as a rough tool. You may need to dicker with the files produced. You have to run this program by hand; it's not run as part of the Perl installation. Doesn't handle complicated expressions built piecemeal, a la: enum { FIRST_VALUE, SECOND_VALUE, #ifdef ABC THIRD_VALUE #endif }; Doesn't necessarily locate all of your C compiler's internally-defined symbols. ----
One page links to
h2ph(1)
:
Man1h
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
