113 lines
2.2 KiB
Groff
113 lines
2.2 KiB
Groff
.TH EM_OPT 3 "$Revision$"
|
|
.ad
|
|
.SH NAME
|
|
emopt \- EM code peephole optimizer interface for compilers
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B #define PEEPHOLE
|
|
.B #include <em.h>
|
|
.PP
|
|
.B O_init(wsize, psize)
|
|
.B arith wsize, psize;
|
|
.PP
|
|
.B int O_open(filename)
|
|
.B O_close()
|
|
.B int O_busy()
|
|
.B char *filename;
|
|
.PP
|
|
.B O_magic()
|
|
.PP
|
|
.B O_df_dlb(l)
|
|
.B O_df_dnam(s)
|
|
.B O_df_ilb(l)
|
|
.B label l; char *s;
|
|
.PP
|
|
.B O_pro(s, l)
|
|
.B O_pro_narg(s)
|
|
.B O_end(l)
|
|
.B O_end_narg()
|
|
.B char *s; arith l;
|
|
.PP
|
|
.B O_exa_dlb(l)
|
|
.B O_exa_dnam(s)
|
|
.B O_exp(s)
|
|
.B O_ina_dlb(l)
|
|
.B O_ina_dnam(s)
|
|
.B O_inp(s)
|
|
.B char *s; label l;
|
|
.PP
|
|
.BI O_bss_ cstp ()
|
|
.BI O_hol_ cstp ()
|
|
.BI O_con_ cstp ()
|
|
.BI O_rom_ cstp ()
|
|
.PP
|
|
.B #include <em_mes.h>
|
|
.B O_mes_begin(ms)
|
|
.BI O_ cstp ()
|
|
.B O_mes_end()
|
|
.B int ms;
|
|
.PP
|
|
.B O_exc(c1, c2)
|
|
.B arith c1, c2;
|
|
.PP
|
|
.BI O_ mnem ()
|
|
.BI O_ mnem _dlb()
|
|
.BI O_ mnem _dnam()
|
|
.BI O_ mnem _narg()
|
|
.PP
|
|
.B O_insertpart(id)
|
|
.B int id;
|
|
.PP
|
|
.B O_beginpart(id)
|
|
.B int id;
|
|
.PP
|
|
.B O_endpart(id)
|
|
.B int id;
|
|
.fi
|
|
.SH DESCRIPTION
|
|
This package provides a procedural EM code peephole optimizer interface to be
|
|
used in compilers and other EM code producing programs. The interface
|
|
routines are identical to the EM_CODE(3) procedure interface except that all
|
|
names have been replaced by
|
|
.I O_xxx
|
|
It is possible to convert
|
|
a program that is currently using the EM_CODE interface
|
|
to use this module instead by defining
|
|
.I PEEPHOLE
|
|
before including
|
|
.I em.h.
|
|
This defines a series of macros to map all the
|
|
.I C_xxx
|
|
names to the corresponding
|
|
.I O_xxx
|
|
names. The module in turn calls
|
|
.I C_xxx
|
|
routines to output the optimized code. Hence it is possible to add peephole
|
|
optimization to any program that outputs EM code using the EM_CODE module.
|
|
.PP
|
|
Details of the
|
|
.I O_xxx
|
|
routines may be obtained by referring to the description
|
|
of the corresponding
|
|
.I C_xxx
|
|
routine in EM_CODE(3).
|
|
.SH FILES
|
|
.nf
|
|
~em/modules/h/em.h
|
|
~em/modules/lib/libemopt.a
|
|
.fi
|
|
.SH MODULES
|
|
.nf
|
|
alloc(3), system(3), string(3), em_code(3)
|
|
.fi
|
|
.SH SEE ALSO
|
|
em_nopt(1) em_code(3), read_em(3), em_mes(3)
|
|
.SH DIAGNOSTICS
|
|
.I O_open
|
|
returns 1 if the open is successful and 0 if not.
|
|
.SH BUGS
|
|
It is not possible to indicate that the argument of
|
|
.B O_con_cst ()
|
|
must be seen as an unsigned value.
|
|
.SH AUTHOR
|
|
Bruce McKenzie <bruce@cocs.canterbury.ac.nz>
|