icon Top 9 categories map      RocketAware >

h2ph(1)

Tips: Browse or Search all pages for efficient awareness of more than 6000 of the most popular reusable and open source applications, functions, libraries, and FAQs.


The "RKT couplings" below include links to source code, updates, additional information, advice, FAQs, and overviews.


Home

Search all pages


Subjects

By activity
Professions, Sciences, Humanities, Business, ...

User Interface
Text-based, GUI, Audio, Video, Keyboards, Mouse, Images,...

Text Strings
Conversions, tests, processing, manipulation,...

Math
Integer, Floating point, Matrix, Statistics, Boolean, ...

Processing
Algorithms, Memory, Process control, Debugging, ...

Stored Data
Data storage, Integrity, Encryption, Compression, ...

Communications
Networks, protocols, Interprocess, Remote, Client Server, ...

Hard World
Timing, Calendar and Clock, Audio, Video, Printer, Controls...

File System
Management, Filtering, File & Directory access, Viewers, ...

    

RocketLink!--> Man page versions: FreeBSD Others






H2PH(1)          Perl Programmers Reference Guide         H2PH(1)


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




31/Oct/1999            perl 5.005, patch 03                     1





H2PH(1)          Perl Programmers Reference Guide         H2PH(1)


                   [ 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.

       Doesn't run with use strict

       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:










31/Oct/1999            perl 5.005, patch 03                     2





H2PH(1)          Perl Programmers Reference Guide         H2PH(1)


           enum {
               FIRST_VALUE,
               SECOND_VALUE,
           #ifdef ABC
               THIRD_VALUE
           #endif
           };

       Doesn't necessarily locate all of your C compiler's
       internally-defined symbols.















































31/Oct/1999            perl 5.005, patch 03                     3



Source: OpenBSD 2.6 man pages. Copyright: Portions are copyrighted by BERKELEY
SOFTWARE DESIGN, INC., The Regents of the University of California, Massachusetts
Institute of Technology, Free Software Foundation, FreeBSD Inc., and others.



(Corrections, notes, and links courtesy of RocketAware.com)


[Detailed Topics]
PERL sources for h2ph(1) (at OpenBSD cvsweb)


[Overview Topics]

Up to: PERL


RocketLink!--> Man page versions: FreeBSD Others






Rapid-Links: Search | About | Comments | Submit Path: RocketAware > h2ph.1/
RocketAware.com is a service of Mib Software
Copyright 1999, Forrest J. Cavalier III. All Rights Reserved.
We welcome submissions and comments