GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  H2PH (1)

.ds Aq ’

NAME

h2ph - convert .h C header files to .ph Perl header files

CONTENTS

SYNOPSIS

<B>h2ph [-d destination directory] [-r | -a] [-l] [-h] [-e] [-D] [-Q] [headerfiles]B>

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 * sys/* arpa/* netinet/*



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 <B>-dB> switch.

If run with no arguments, filters standard input to standard output.

OPTIONS

-d destination_dir Put the resulting <B>.phB> files beneath <B>destination_dirB>, instead of beneath the default Perl library location ($Config{installsitearch}).
-r Run recursively; if any of <B>headerfilesB> are directories, then run h2ph on all files in those directories (and their subdirectories, etc.). <B>-rB> and <B>-aB> are mutually exclusive.
-a Run automagically; convert <B>headerfilesB>, as well as any <B>.hB> files which they include. This option will search for <B>.hB> files in all directories which your C compiler ordinarily uses. <B>-aB> and <B>-rB> are mutually exclusive.
-l Symbolic links will be replicated in the destination directory. If <B>-lB> 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 <B>requireB> a <B>.phB> 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 <B>.phB> files almost double in size when built using <B>-hB>.

-e If an error is encountered during conversion, output file will be removed and a warning emitted instead of terminating the conversion immediately.
-D Include the code from the <B>.hB> file as a comment in the <B>.phB> 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.

Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.22.1 H2PH (1) 2016-03-18

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.