This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Remove old #define NEED_vnewSVpvf
[perl5.git] / dist / Devel-PPPort / parts / apicheck.pl
CommitLineData
adfe19db
MHM
1#!/usr/bin/perl -w
2################################################################################
3#
4# apicheck.pl -- generate C source for automated API check
5#
6################################################################################
7#
b2049988 8# Version 3.x, Copyright (C) 2004-2013, Marcus Holland-Moritz.
adfe19db
MHM
9# Version 2.x, Copyright (C) 2001, Paul Marquess.
10# Version 1.x, Copyright (C) 1999, Kenneth Albanowski.
11#
12# This program is free software; you can redistribute it and/or
13# modify it under the same terms as Perl itself.
14#
15################################################################################
16
17use strict;
3d7c117d 18require './parts/ppptools.pl';
adfe19db
MHM
19
20if (@ARGV) {
0c96388f
MHM
21 my $file = pop @ARGV;
22 open OUT, ">$file" or die "$file: $!\n";
adfe19db
MHM
23}
24else {
25 *OUT = \*STDOUT;
26}
27
679ad62d 28my @f = parse_embed(qw( parts/embed.fnc parts/apidoc.fnc parts/ppport.fnc ));
adfe19db
MHM
29
30my %todo = %{&parse_todo};
31
32my %tmap = (
33 void => 'int',
34);
35
36my %amap = (
37 SP => 'SP',
38 type => 'int',
39 cast => 'int',
40);
41
42my %void = (
43 void => 1,
44 Free_t => 1,
45 Signal_t => 1,
46);
47
48my %castvoid = (
49 map { ($_ => 1) } qw(
50 Nullav
51 Nullcv
52 Nullhv
53 Nullch
54 Nullsv
55 HEf_SVKEY
56 SP
57 MARK
58 SVt_PV
59 SVt_IV
60 SVt_NV
61 SVt_PVMG
62 SVt_PVAV
63 SVt_PVHV
64 SVt_PVCV
65 SvUOK
66 G_SCALAR
67 G_ARRAY
68 G_VOID
69 G_DISCARD
70 G_EVAL
71 G_NOARGS
72 XS_VERSION
73 ),
74);
75
76my %ignorerv = (
77 map { ($_ => 1) } qw(
78 newCONSTSUB
79 ),
80);
81
82my %stack = (
4a582685
NC
83 ORIGMARK => ['dORIGMARK;'],
84 POPpx => ['STRLEN n_a;'],
85 POPpbytex => ['STRLEN n_a;'],
86 PUSHp => ['dTARG;'],
87 PUSHn => ['dTARG;'],
88 PUSHi => ['dTARG;'],
89 PUSHu => ['dTARG;'],
90 XPUSHp => ['dTARG;'],
91 XPUSHn => ['dTARG;'],
92 XPUSHi => ['dTARG;'],
93 XPUSHu => ['dTARG;'],
94 UNDERBAR => ['dUNDERBAR;'],
95 XCPT_TRY_START => ['dXCPT;'],
96 XCPT_TRY_END => ['dXCPT;'],
97 XCPT_CATCH => ['dXCPT;'],
98 XCPT_RETHROW => ['dXCPT;'],
adfe19db
MHM
99);
100
adfe19db
MHM
101my %ignore = (
102 map { ($_ => 1) } qw(
103 svtype
104 items
105 ix
106 dXSI32
107 XS
108 CLASS
109 THIS
110 RETVAL
111 StructCopy
112 ),
113);
114
115print OUT <<HEAD;
116/*
117 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
118 * This file is built by $0.
119 * Any changes made here will be lost!
120 */
121
122#include "EXTERN.h"
123#include "perl.h"
4a582685
NC
124
125#define NO_XSLOCKS
adfe19db
MHM
126#include "XSUB.h"
127
ba120f6f
MHM
128#ifdef DPPP_APICHECK_NO_PPPORT_H
129
130/* This is just to avoid too many baseline failures with perls < 5.6.0 */
131
132#ifndef dTHX
133# define dTHX extern int Perl___notused
134#endif
135
136#else
adfe19db 137
679ad62d 138#define NEED_PL_signals
c01be2ce 139#define NEED_PL_parser
744ef08f 140#define NEED_caller_cx
adfe19db
MHM
141#define NEED_eval_pv
142#define NEED_grok_bin
143#define NEED_grok_hex
144#define NEED_grok_number
145#define NEED_grok_numeric_radix
146#define NEED_grok_oct
679ad62d 147#define NEED_load_module
94e22bd6 148#define NEED_mg_findext
f2ab5a41 149#define NEED_my_snprintf
c01be2ce 150#define NEED_my_sprintf
aef0a14c
MHM
151#define NEED_my_strlcat
152#define NEED_my_strlcpy
adfe19db 153#define NEED_newCONSTSUB
c83e6f19 154#define NEED_newSVpvn_share
db42c902
MHM
155#define NEED_pv_display
156#define NEED_pv_escape
157#define NEED_pv_pretty
96ad942f
MHM
158#define NEED_sv_catpvf_mg
159#define NEED_sv_catpvf_mg_nocontext
160#define NEED_sv_setpvf_mg
161#define NEED_sv_setpvf_mg_nocontext
744ef08f 162#define NEED_sv_unmagicext
679ad62d 163#define NEED_vload_module
f2ab5a41 164#define NEED_warner
96ad942f 165
adfe19db
MHM
166#include "ppport.h"
167
168#endif
169
adfe19db
MHM
170static int VARarg1;
171static char *VARarg2;
172static double VARarg3;
173
744ef08f
CBW
174#if defined(PERL_BCDVERSION) && (PERL_BCDVERSION < 0x5009005)
175/* needed to make PL_parser apicheck work */
176typedef void yy_parser;
177#endif
178
adfe19db
MHM
179HEAD
180
0c96388f
MHM
181if (@ARGV) {
182 my %want = map { ($_ => 0) } @ARGV;
183 @f = grep { exists $want{$_->{name}} } @f;
184 for (@f) { $want{$_->{name}}++ }
185 for (keys %want) {
186 die "nothing found for '$_'\n" unless $want{$_};
187 }
188}
189
adfe19db
MHM
190my $f;
191for $f (@f) {
192 $ignore{$f->{name}} and next;
193 $f->{flags}{A} or next; # only public API members
194
195 $ignore{$f->{name}} = 1; # ignore duplicates
196
197 my $Perl_ = $f->{flags}{p} ? 'Perl_' : '';
198
199 my $stack = '';
200 my @arg;
201 my $aTHX = '';
202
203 my $i = 1;
204 my $ca;
205 my $varargs = 0;
206 for $ca (@{$f->{args}}) {
207 my $a = $ca->[0];
208 if ($a eq '...') {
209 $varargs = 1;
210 push @arg, qw(VARarg1 VARarg2 VARarg3);
211 last;
212 }
4a582685
NC
213 my($n, $p, $d) = $a =~ /^ (\w+(?:\s+\w+)*)\s* # type name => $n
214 (\**) # pointer => $p
f2ab5a41 215 (?:\s*const\s*)? # const
4a582685
NC
216 ((?:\[[^\]]*\])*) # dimension => $d
217 $/x
218 or die "$0 - cannot parse argument: [$a]\n";
adfe19db
MHM
219 if (exists $amap{$n}) {
220 push @arg, $amap{$n};
221 next;
222 }
223 $n = $tmap{$n} || $n;
0c96388f
MHM
224 if ($n eq 'const char' and $p eq '*' and !$f->{flags}{f}) {
225 push @arg, '"foo"';
226 }
227 else {
228 my $v = 'arg' . $i++;
229 push @arg, $v;
230 $stack .= " static $n $p$v$d;\n";
231 }
adfe19db
MHM
232 }
233
fc4763de 234 unless ($f->{flags}{'T'} || $f->{flags}{'m'}) {
adfe19db
MHM
235 $stack = " dTHX;\n$stack";
236 $aTHX = @arg ? 'aTHX_ ' : 'aTHX';
237 }
238
239 if ($stack{$f->{name}}) {
240 my $s = '';
241 for (@{$stack{$f->{name}}}) {
242 $s .= " $_\n";
243 }
244 $stack = "$s$stack";
245 }
246
247 my $args = join ', ', @arg;
248 my $rvt = $f->{ret} || 'void';
249 my $ret;
250 if ($void{$rvt}) {
251 $ret = $castvoid{$f->{name}} ? '(void) ' : '';
252 }
253 else {
ba120f6f
MHM
254 $stack .= " $rvt rval;\n";
255 $ret = $ignorerv{$f->{name}} ? '(void) ' : "rval = ";
adfe19db
MHM
256 }
257 my $aTHX_args = "$aTHX$args";
258
49ef49fe 259 if (!$f->{flags}{'m'} or $f->{flags}{'b'} or @arg > 0) {
adfe19db
MHM
260 $args = "($args)";
261 $aTHX_args = "($aTHX_args)";
262 }
263
264 print OUT <<HEAD;
265/******************************************************************************
266*
267* $f->{name}
268*
269******************************************************************************/
270
271HEAD
272
273 if ($todo{$f->{name}}) {
274 my($ver,$sub) = $todo{$f->{name}} =~ /^5\.(\d{3})(\d{3})$/ or die;
275 for ($ver, $sub) {
276 s/^0+(\d)/$1/
277 }
278 if ($ver < 6 && $sub > 0) {
279 $sub =~ s/0$// or die;
280 }
281 print OUT "#if PERL_VERSION > $ver || (PERL_VERSION == $ver && PERL_SUBVERSION >= $sub) /* TODO */\n";
282 }
283
284 my $final = $varargs
285 ? "$Perl_$f->{name}$aTHX_args"
286 : "$f->{name}$args";
287
288 $f->{cond} and print OUT "#if $f->{cond}\n";
289
290 print OUT <<END;
ba120f6f 291void _DPPP_test_$f->{name} (void)
adfe19db
MHM
292{
293 dXSARGS;
294$stack
adfe19db 295 {
ba120f6f
MHM
296#ifdef $f->{name}
297 $ret$f->{name}$args;
adfe19db 298#endif
ba120f6f 299 }
adfe19db
MHM
300
301 {
302#ifdef $f->{name}
ba120f6f 303 $ret$final;
adfe19db 304#else
ba120f6f 305 $ret$Perl_$f->{name}$aTHX_args;
adfe19db
MHM
306#endif
307 }
308}
309END
310
311 $f->{cond} and print OUT "#endif\n";
312 $todo{$f->{name}} and print OUT "#endif\n";
313
314 print OUT "\n";
315}
316
317@ARGV and close OUT;