~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

<div id="contentBody"><div class="title_container"><div class="page_title">c2ph</div></div><ul><li><a href="#NAME">NAME</a><li><a href="#SYNOPSIS">SYNOPSIS</a><ul><li><a href="#OPTIONS">OPTIONS</a></ul><li><a href="#DESCRIPTION">DESCRIPTION</a></ul><a name="NAME"></a><h1>NAME</h1>

c2ph, pstruct - Dump C structures as generated from <code class="inline">cc -g -S</code>

c2ph, pstruct - Dump C structures as generated from <code class="inline">cc -g -S</code>

stabs

<a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>

<pre class="verbatim"> c2ph [-dpnP] [var=val] [files ...]</pre>

<pre class="verbatim"> c2ph [-dpnP] [var=val] [files ...]</pre>

<a name="OPTIONS"></a><h2>OPTIONS</h2>

<pre class="verbatim"> Options:</pre>

<pre class="verbatim"> -w wide; short for: type_width=45 member_width=35 offset_width=8

-x hex; short for: offset_fmt=x offset_width=08 size_fmt=x size_width=04</pre><pre class="verbatim"> -n <a class="l_k" href="functions/do.html">do</a> not generate perl code (default when invoked as pstruct)

-p generate perl code (default when invoked as c2ph)

-v generate perl code, with C decls as comments</pre>

<pre class="verbatim"> -i <a class="l_k" href="functions/do.html">do</a> NOT recompute sizes for intrinsic datatypes

-a <a class="l_k" href="functions/dump.html">dump</a> information on intrinsics also</pre>

<pre class="verbatim"> -t trace execution

-d spew reams of debugging output</pre>

<pre class="verbatim"> -slist give comma-separated list a structures to <a class="l_k" href="functions/dump.html">dump</a></pre>

-x hex; short for: offset_fmt=x offset_width=08 size_fmt=x size_width=04</pre><pre class="verbatim"> -n <a class="l_k" href="functions/do.html">do</a> not generate perl code (default when invoked as pstruct)

-p generate perl code (default when invoked as c2ph)

-v generate perl code, with C decls as comments</pre>

<pre class="verbatim"> -i <a class="l_k" href="functions/do.html">do</a> NOT recompute sizes for intrinsic datatypes

-a <a class="l_k" href="functions/dump.html">dump</a> information on intrinsics also</pre>

100

<pre class="verbatim"> -t trace execution

101

-d spew reams of debugging output</pre>

102

<pre class="verbatim"> -slist give comma-separated list a structures to <a class="l_k" href="functions/dump.html">dump</a></pre>

100

103

<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>

101

104

The following is the old c2ph.doc documentation by Tom Christiansen

102

105

<tchrist@perl.com>

192

195

As you see, the name of the package is the name of the structure. Regular

193

196

fields are just their own names. Plus the following accessor functions are

194

197

provided for your convenience:

195

<pre class="verbatim"> struct This takes <a class="l_k" href="functions/no.html">no</a> arguments, and is merely the number of first-level

196

elements in the structure. You would <a class="l_k" href="functions/use.html">use</a> this for indexing

197

into arrays of structures, perhaps like this</pre>

198

<pre class="verbatim"> struct This takes <a class="l_k" href="functions/no.html">no</a> arguments, and is merely the number of first-level

199

elements in the structure. You would <a class="l_k" href="functions/use.html">use</a> this for indexing

200

into arrays of structures, perhaps like this</pre>

198

201

<pre class="verbatim"> $usec = $u[ &user'u_utimer

199

202

+ (&ITIMER_VIRTUAL * &itimerval'struct)

200

203

+ &itimerval'it_value

201

204

+ &timeval'tv_usec

202

205

];</pre>

203

<pre class="verbatim"> sizeof Returns the <a class="l_w" href="bytes.html">bytes</a> in the structure, or the member if

204

you pass it an argument, such as</pre>

206

<pre class="verbatim"> sizeof Returns the bytes in the structure, or the member if

207

you pass it an argument, such as</pre>

205

208

<pre class="verbatim"> &rusage'sizeof(&rusage'ru_utime)</pre>

206

209

<pre class="verbatim"> typedef This is the perl format definition for passing to pack and

207

210

unpack. If you ask for the typedef of a nothing, you get

208

211

the whole structure, otherwise you get that of the member

209

212

you ask for. Padding is taken care of, as is the magic to

210

213

guarantee that a union is unpacked into all its aliases.

211

Bitfields are not quite yet supported however.</pre><pre class="verbatim"> offsetof This function is the byte offset into the array of that

212

member. You may wish to <a class="l_k" href="functions/use.html">use</a> this for indexing directly

213

into the packed structure with <a class="l_k" href="functions/vec.html">vec</a>() if you're too lazy

214

to <a class="l_k" href="functions/unpack.html">unpack</a> it.</pre>

215

<pre class="verbatim"> typeof Not to be confused with the typedef accessor function, this

216

one returns the C type of that field. This would allow

217

you to <a class="l_k" href="functions/print.html">print</a> out a nice structured pretty <a class="l_k" href="functions/print.html">print</a> of some

218

structure without knoning anything about it beforehand.

219

No args to this one is a noop. Someday I'll post such

220

a thing to <a class="l_k" href="functions/dump.html">dump</a> out your u structure for you.</pre>

214

Bitfields are not quite yet supported however.</pre><pre class="verbatim"> offsetof This function is the byte offset into the array of that

215

member. You may wish to <a class="l_k" href="functions/use.html">use</a> this for indexing directly

216

into the packed structure with <a class="l_k" href="functions/vec.html">vec</a>() if you're too lazy

217

to <a class="l_k" href="functions/unpack.html">unpack</a> it.</pre>

218

<pre class="verbatim"> typeof Not to be confused with the typedef accessor function, this

219

one returns the C type of that field. This would allow

220

you to <a class="l_k" href="functions/print.html">print</a> out a nice structured pretty <a class="l_k" href="functions/print.html">print</a> of some

221

structure without knoning anything about it beforehand.

222

No args to this one is a noop. Someday I'll post such

223

a thing to <a class="l_k" href="functions/dump.html">dump</a> out your u structure for you.</pre>

221

224

The way I see this being used is like basically this:

222

225

<pre class="verbatim"> % h2ph <some_include_file.h > /usr/lib/perl/tmp.ph

223

226

% c2ph some_include_file.h >> /usr/lib/perl/tmp.ph

230

233

of the stabs on the fly, and then account for micro differences between my

231

234

compiler and gcc.

232

235

Anyway, here it is. Should run on perl v4 or greater. Maybe less.

233

236

234

237

</div>

235

238

236

239

</div>

248

251

249

252

</form>

250

253

254

251

255

<h2>Labels:</h2>

252

256

253

257

Older »