xref: /titanic_50/usr/src/lib/libdwarf/common/dwarf_frame3.c (revision f3e7f55e73a39377d55a030f124cc86b3b66a9cc)
1*f3e7f55eSRobert Mustacchi /*
2*f3e7f55eSRobert Mustacchi 
3*f3e7f55eSRobert Mustacchi   Copyright (C) 2000-2006 Silicon Graphics, Inc.  All Rights Reserved.
4*f3e7f55eSRobert Mustacchi   Portions Copyright (C) 2009-2010 David Anderson. All Rights Reserved.
5*f3e7f55eSRobert Mustacchi 
6*f3e7f55eSRobert Mustacchi   This program is free software; you can redistribute it and/or modify it
7*f3e7f55eSRobert Mustacchi   under the terms of version 2.1 of the GNU Lesser General Public License
8*f3e7f55eSRobert Mustacchi   as published by the Free Software Foundation.
9*f3e7f55eSRobert Mustacchi 
10*f3e7f55eSRobert Mustacchi   This program is distributed in the hope that it would be useful, but
11*f3e7f55eSRobert Mustacchi   WITHOUT ANY WARRANTY; without even the implied warranty of
12*f3e7f55eSRobert Mustacchi   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13*f3e7f55eSRobert Mustacchi 
14*f3e7f55eSRobert Mustacchi   Further, this software is distributed without any warranty that it is
15*f3e7f55eSRobert Mustacchi   free of the rightful claim of any third person regarding infringement
16*f3e7f55eSRobert Mustacchi   or the like.  Any license provided herein, whether implied or
17*f3e7f55eSRobert Mustacchi   otherwise, applies only to this software file.  Patent licenses, if
18*f3e7f55eSRobert Mustacchi   any, provided herein do not apply to combinations of this program with
19*f3e7f55eSRobert Mustacchi   other software, or any other product whatsoever.
20*f3e7f55eSRobert Mustacchi 
21*f3e7f55eSRobert Mustacchi   You should have received a copy of the GNU Lesser General Public
22*f3e7f55eSRobert Mustacchi   License along with this program; if not, write the Free Software
23*f3e7f55eSRobert Mustacchi   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston MA 02110-1301,
24*f3e7f55eSRobert Mustacchi   USA.
25*f3e7f55eSRobert Mustacchi 
26*f3e7f55eSRobert Mustacchi   Contact information:  Silicon Graphics, Inc., 1500 Crittenden Lane,
27*f3e7f55eSRobert Mustacchi   Mountain View, CA 94043, or:
28*f3e7f55eSRobert Mustacchi 
29*f3e7f55eSRobert Mustacchi   http://www.sgi.com
30*f3e7f55eSRobert Mustacchi 
31*f3e7f55eSRobert Mustacchi   For further information regarding this notice, see:
32*f3e7f55eSRobert Mustacchi 
33*f3e7f55eSRobert Mustacchi   http://oss.sgi.com/projects/GenInfo/NoticeExplan
34*f3e7f55eSRobert Mustacchi 
35*f3e7f55eSRobert Mustacchi */
36*f3e7f55eSRobert Mustacchi 
37*f3e7f55eSRobert Mustacchi 
38*f3e7f55eSRobert Mustacchi 
39*f3e7f55eSRobert Mustacchi #include "config.h"
40*f3e7f55eSRobert Mustacchi #include "dwarf_incl.h"
41*f3e7f55eSRobert Mustacchi #include <stdio.h>
42*f3e7f55eSRobert Mustacchi #include <stdlib.h>
43*f3e7f55eSRobert Mustacchi #include "dwarf_frame.h"
44*f3e7f55eSRobert Mustacchi #include "dwarf_arange.h" /* using Arange as a way to build a list */
45*f3e7f55eSRobert Mustacchi 
46*f3e7f55eSRobert Mustacchi /*
47*f3e7f55eSRobert Mustacchi     Used by rqs (an IRIX application).
48*f3e7f55eSRobert Mustacchi     Not needed except for that one application.
49*f3e7f55eSRobert Mustacchi     Should be moved to its own source file since
50*f3e7f55eSRobert Mustacchi     it is so rarely needed.
51*f3e7f55eSRobert Mustacchi     Returns DW_DLV_OK if returns the arrays.
52*f3e7f55eSRobert Mustacchi     Returns DW_DLV_NO_ENTRY if no section. ?? (How do I tell?)
53*f3e7f55eSRobert Mustacchi     Returns DW_DLV_ERROR if there is an error.
54*f3e7f55eSRobert Mustacchi 
55*f3e7f55eSRobert Mustacchi     Uses DW_FRAME_CFA_COL because IRIX is only DWARF2
56*f3e7f55eSRobert Mustacchi     and that is what IRIX compilers and compatible
57*f3e7f55eSRobert Mustacchi     compilers support on IRIX.
58*f3e7f55eSRobert Mustacchi */
59*f3e7f55eSRobert Mustacchi int
_dwarf_frame_address_offsets(Dwarf_Debug dbg,Dwarf_Addr ** addrlist,Dwarf_Off ** offsetlist,Dwarf_Signed * returncount,Dwarf_Error * err)60*f3e7f55eSRobert Mustacchi _dwarf_frame_address_offsets(Dwarf_Debug dbg, Dwarf_Addr ** addrlist,
61*f3e7f55eSRobert Mustacchi                              Dwarf_Off ** offsetlist,
62*f3e7f55eSRobert Mustacchi                              Dwarf_Signed * returncount,
63*f3e7f55eSRobert Mustacchi                              Dwarf_Error * err)
64*f3e7f55eSRobert Mustacchi {
65*f3e7f55eSRobert Mustacchi     int retval = DW_DLV_OK;
66*f3e7f55eSRobert Mustacchi     int res = DW_DLV_ERROR;
67*f3e7f55eSRobert Mustacchi     Dwarf_Cie *cie_data;
68*f3e7f55eSRobert Mustacchi     Dwarf_Signed cie_count;
69*f3e7f55eSRobert Mustacchi     Dwarf_Fde *fde_data;
70*f3e7f55eSRobert Mustacchi     Dwarf_Signed fde_count;
71*f3e7f55eSRobert Mustacchi     Dwarf_Signed i;
72*f3e7f55eSRobert Mustacchi     Dwarf_Frame_Op *frame_inst;
73*f3e7f55eSRobert Mustacchi     Dwarf_Fde fdep;
74*f3e7f55eSRobert Mustacchi     Dwarf_Cie ciep;
75*f3e7f55eSRobert Mustacchi     Dwarf_Chain curr_chain = 0;
76*f3e7f55eSRobert Mustacchi     Dwarf_Chain head_chain = 0;
77*f3e7f55eSRobert Mustacchi     Dwarf_Chain prev_chain = 0;
78*f3e7f55eSRobert Mustacchi     Dwarf_Arange arange;
79*f3e7f55eSRobert Mustacchi     Dwarf_Unsigned arange_count = 0;
80*f3e7f55eSRobert Mustacchi     Dwarf_Addr *arange_addrs = 0;
81*f3e7f55eSRobert Mustacchi     Dwarf_Off *arange_offsets = 0;
82*f3e7f55eSRobert Mustacchi 
83*f3e7f55eSRobert Mustacchi     res = dwarf_get_fde_list(dbg, &cie_data, &cie_count,
84*f3e7f55eSRobert Mustacchi                              &fde_data, &fde_count, err);
85*f3e7f55eSRobert Mustacchi     if (res != DW_DLV_OK) {
86*f3e7f55eSRobert Mustacchi         return res;
87*f3e7f55eSRobert Mustacchi     }
88*f3e7f55eSRobert Mustacchi 
89*f3e7f55eSRobert Mustacchi     res = _dwarf_load_section(dbg, &dbg->de_debug_frame, err);
90*f3e7f55eSRobert Mustacchi     if (res != DW_DLV_OK) {
91*f3e7f55eSRobert Mustacchi         return res;
92*f3e7f55eSRobert Mustacchi     }
93*f3e7f55eSRobert Mustacchi 
94*f3e7f55eSRobert Mustacchi     for (i = 0; i < cie_count; i++) {
95*f3e7f55eSRobert Mustacchi         Dwarf_Off instoff = 0;
96*f3e7f55eSRobert Mustacchi         Dwarf_Signed initial_instructions_length = 0;
97*f3e7f55eSRobert Mustacchi         Dwarf_Small *instr_end = 0;
98*f3e7f55eSRobert Mustacchi         Dwarf_Sword icount = 0;
99*f3e7f55eSRobert Mustacchi         int j = 0;
100*f3e7f55eSRobert Mustacchi         int dw_err;
101*f3e7f55eSRobert Mustacchi 
102*f3e7f55eSRobert Mustacchi         ciep = cie_data[i];
103*f3e7f55eSRobert Mustacchi         instoff = ciep->ci_cie_instr_start - dbg->de_debug_frame.dss_data;
104*f3e7f55eSRobert Mustacchi         initial_instructions_length = ciep->ci_length +
105*f3e7f55eSRobert Mustacchi             ciep->ci_length_size + ciep->ci_extension_size -
106*f3e7f55eSRobert Mustacchi             (ciep->ci_cie_instr_start - ciep->ci_cie_start);
107*f3e7f55eSRobert Mustacchi         instr_end = ciep->ci_cie_instr_start +
108*f3e7f55eSRobert Mustacchi             initial_instructions_length;
109*f3e7f55eSRobert Mustacchi         res = _dwarf_exec_frame_instr( /* make_instr */ true,
110*f3e7f55eSRobert Mustacchi             &frame_inst,
111*f3e7f55eSRobert Mustacchi             /* search_pc= */ false,
112*f3e7f55eSRobert Mustacchi             /* search_pc_val= */ 0,
113*f3e7f55eSRobert Mustacchi             /* location */ 0,
114*f3e7f55eSRobert Mustacchi             ciep->ci_cie_instr_start,
115*f3e7f55eSRobert Mustacchi             instr_end,
116*f3e7f55eSRobert Mustacchi             /* Dwarf_frame= */ 0,
117*f3e7f55eSRobert Mustacchi             /* cie= */ 0,
118*f3e7f55eSRobert Mustacchi             dbg,
119*f3e7f55eSRobert Mustacchi             DW_FRAME_CFA_COL,
120*f3e7f55eSRobert Mustacchi             &icount, &dw_err);
121*f3e7f55eSRobert Mustacchi         if (res == DW_DLV_ERROR) {
122*f3e7f55eSRobert Mustacchi             _dwarf_error(dbg, err, dw_err);
123*f3e7f55eSRobert Mustacchi             return (res);
124*f3e7f55eSRobert Mustacchi         } else if (res == DW_DLV_NO_ENTRY) {
125*f3e7f55eSRobert Mustacchi             continue;
126*f3e7f55eSRobert Mustacchi         }
127*f3e7f55eSRobert Mustacchi 
128*f3e7f55eSRobert Mustacchi         for (j = 0; j < icount; ++j) {
129*f3e7f55eSRobert Mustacchi             Dwarf_Frame_Op *finst = frame_inst + j;
130*f3e7f55eSRobert Mustacchi 
131*f3e7f55eSRobert Mustacchi             if (finst->fp_base_op == 0 && finst->fp_extended_op == 1) {
132*f3e7f55eSRobert Mustacchi                 /* is DW_CFA_set_loc */
133*f3e7f55eSRobert Mustacchi                 Dwarf_Addr add = (Dwarf_Addr) finst->fp_offset;
134*f3e7f55eSRobert Mustacchi                 Dwarf_Off off = finst->fp_instr_offset + instoff;
135*f3e7f55eSRobert Mustacchi 
136*f3e7f55eSRobert Mustacchi                 arange = (Dwarf_Arange)
137*f3e7f55eSRobert Mustacchi                     _dwarf_get_alloc(dbg, DW_DLA_ARANGE, 1);
138*f3e7f55eSRobert Mustacchi                 if (arange == NULL) {
139*f3e7f55eSRobert Mustacchi                     _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
140*f3e7f55eSRobert Mustacchi                     return (DW_DLV_ERROR);
141*f3e7f55eSRobert Mustacchi                 }
142*f3e7f55eSRobert Mustacchi                 arange->ar_address = add;
143*f3e7f55eSRobert Mustacchi                 arange->ar_info_offset = off;
144*f3e7f55eSRobert Mustacchi                 arange_count++;
145*f3e7f55eSRobert Mustacchi                 curr_chain = (Dwarf_Chain)
146*f3e7f55eSRobert Mustacchi                     _dwarf_get_alloc(dbg, DW_DLA_CHAIN, 1);
147*f3e7f55eSRobert Mustacchi                 if (curr_chain == NULL) {
148*f3e7f55eSRobert Mustacchi                     _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
149*f3e7f55eSRobert Mustacchi                     return (DW_DLV_ERROR);
150*f3e7f55eSRobert Mustacchi                 }
151*f3e7f55eSRobert Mustacchi                 curr_chain->ch_item = arange;
152*f3e7f55eSRobert Mustacchi                 if (head_chain == NULL)
153*f3e7f55eSRobert Mustacchi                     head_chain = prev_chain = curr_chain;
154*f3e7f55eSRobert Mustacchi                 else {
155*f3e7f55eSRobert Mustacchi                     prev_chain->ch_next = curr_chain;
156*f3e7f55eSRobert Mustacchi                     prev_chain = curr_chain;
157*f3e7f55eSRobert Mustacchi                 }
158*f3e7f55eSRobert Mustacchi             }
159*f3e7f55eSRobert Mustacchi         }
160*f3e7f55eSRobert Mustacchi         dwarf_dealloc(dbg, frame_inst, DW_DLA_FRAME_BLOCK);
161*f3e7f55eSRobert Mustacchi 
162*f3e7f55eSRobert Mustacchi     }
163*f3e7f55eSRobert Mustacchi     for (i = 0; i < fde_count; i++) {
164*f3e7f55eSRobert Mustacchi         Dwarf_Small *instr_end = 0;
165*f3e7f55eSRobert Mustacchi         Dwarf_Sword icount = 0;
166*f3e7f55eSRobert Mustacchi         Dwarf_Signed instructions_length = 0;
167*f3e7f55eSRobert Mustacchi         Dwarf_Off instoff = 0;
168*f3e7f55eSRobert Mustacchi         Dwarf_Off off = 0;
169*f3e7f55eSRobert Mustacchi         Dwarf_Addr addr = 0;
170*f3e7f55eSRobert Mustacchi         int j = 0;
171*f3e7f55eSRobert Mustacchi         int dw_err;
172*f3e7f55eSRobert Mustacchi 
173*f3e7f55eSRobert Mustacchi         fdep = fde_data[i];
174*f3e7f55eSRobert Mustacchi         off = fdep->fd_initial_loc_pos - dbg->de_debug_frame.dss_data;
175*f3e7f55eSRobert Mustacchi         addr = fdep->fd_initial_location;
176*f3e7f55eSRobert Mustacchi         arange = (Dwarf_Arange)
177*f3e7f55eSRobert Mustacchi             _dwarf_get_alloc(dbg, DW_DLA_ARANGE, 1);
178*f3e7f55eSRobert Mustacchi         if (arange == NULL) {
179*f3e7f55eSRobert Mustacchi             _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
180*f3e7f55eSRobert Mustacchi             return (DW_DLV_ERROR);
181*f3e7f55eSRobert Mustacchi         }
182*f3e7f55eSRobert Mustacchi         arange->ar_address = addr;
183*f3e7f55eSRobert Mustacchi         arange->ar_info_offset = off;
184*f3e7f55eSRobert Mustacchi         arange_count++;
185*f3e7f55eSRobert Mustacchi         curr_chain = (Dwarf_Chain)
186*f3e7f55eSRobert Mustacchi             _dwarf_get_alloc(dbg, DW_DLA_CHAIN, 1);
187*f3e7f55eSRobert Mustacchi         if (curr_chain == NULL) {
188*f3e7f55eSRobert Mustacchi             _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
189*f3e7f55eSRobert Mustacchi             return (DW_DLV_ERROR);
190*f3e7f55eSRobert Mustacchi         }
191*f3e7f55eSRobert Mustacchi         curr_chain->ch_item = arange;
192*f3e7f55eSRobert Mustacchi         if (head_chain == NULL)
193*f3e7f55eSRobert Mustacchi             head_chain = prev_chain = curr_chain;
194*f3e7f55eSRobert Mustacchi         else {
195*f3e7f55eSRobert Mustacchi             prev_chain->ch_next = curr_chain;
196*f3e7f55eSRobert Mustacchi             prev_chain = curr_chain;
197*f3e7f55eSRobert Mustacchi         }
198*f3e7f55eSRobert Mustacchi 
199*f3e7f55eSRobert Mustacchi 
200*f3e7f55eSRobert Mustacchi         instoff = fdep->fd_fde_instr_start - dbg->de_debug_frame.dss_data;
201*f3e7f55eSRobert Mustacchi         instructions_length = fdep->fd_length +
202*f3e7f55eSRobert Mustacchi             fdep->fd_length_size + fdep->fd_extension_size -
203*f3e7f55eSRobert Mustacchi             (fdep->fd_fde_instr_start - fdep->fd_fde_start);
204*f3e7f55eSRobert Mustacchi         instr_end = fdep->fd_fde_instr_start + instructions_length;
205*f3e7f55eSRobert Mustacchi         res = _dwarf_exec_frame_instr( /* make_instr */ true,
206*f3e7f55eSRobert Mustacchi             &frame_inst,
207*f3e7f55eSRobert Mustacchi             /* search_pc= */ false,
208*f3e7f55eSRobert Mustacchi             /* search_pc_val= */ 0,
209*f3e7f55eSRobert Mustacchi             /* location */ 0,
210*f3e7f55eSRobert Mustacchi             fdep->fd_fde_instr_start,
211*f3e7f55eSRobert Mustacchi             instr_end,
212*f3e7f55eSRobert Mustacchi             /* Dwarf_frame= */ 0,
213*f3e7f55eSRobert Mustacchi             /* cie= */ 0,
214*f3e7f55eSRobert Mustacchi             dbg,
215*f3e7f55eSRobert Mustacchi             DW_FRAME_CFA_COL,
216*f3e7f55eSRobert Mustacchi             &icount, &dw_err);
217*f3e7f55eSRobert Mustacchi         if (res == DW_DLV_ERROR) {
218*f3e7f55eSRobert Mustacchi             _dwarf_error(dbg, err, dw_err);
219*f3e7f55eSRobert Mustacchi             return (res);
220*f3e7f55eSRobert Mustacchi         } else if (res == DW_DLV_NO_ENTRY) {
221*f3e7f55eSRobert Mustacchi             continue;
222*f3e7f55eSRobert Mustacchi         }
223*f3e7f55eSRobert Mustacchi 
224*f3e7f55eSRobert Mustacchi         for (j = 0; j < icount; ++j) {
225*f3e7f55eSRobert Mustacchi             Dwarf_Frame_Op *finst2 = frame_inst + j;
226*f3e7f55eSRobert Mustacchi 
227*f3e7f55eSRobert Mustacchi             if (finst2->fp_base_op == 0 && finst2->fp_extended_op == 1) {
228*f3e7f55eSRobert Mustacchi                 /* is DW_CFA_set_loc */
229*f3e7f55eSRobert Mustacchi                 Dwarf_Addr add = (Dwarf_Addr) finst2->fp_offset;
230*f3e7f55eSRobert Mustacchi                 Dwarf_Off off = finst2->fp_instr_offset + instoff;
231*f3e7f55eSRobert Mustacchi 
232*f3e7f55eSRobert Mustacchi                 arange = (Dwarf_Arange)
233*f3e7f55eSRobert Mustacchi                     _dwarf_get_alloc(dbg, DW_DLA_ARANGE, 1);
234*f3e7f55eSRobert Mustacchi                 if (arange == NULL) {
235*f3e7f55eSRobert Mustacchi                     _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
236*f3e7f55eSRobert Mustacchi                     return (DW_DLV_ERROR);
237*f3e7f55eSRobert Mustacchi                 }
238*f3e7f55eSRobert Mustacchi                 arange->ar_address = add;
239*f3e7f55eSRobert Mustacchi                 arange->ar_info_offset = off;
240*f3e7f55eSRobert Mustacchi                 arange_count++;
241*f3e7f55eSRobert Mustacchi                 curr_chain = (Dwarf_Chain)
242*f3e7f55eSRobert Mustacchi                     _dwarf_get_alloc(dbg, DW_DLA_CHAIN, 1);
243*f3e7f55eSRobert Mustacchi                 if (curr_chain == NULL) {
244*f3e7f55eSRobert Mustacchi                     _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
245*f3e7f55eSRobert Mustacchi                     return (DW_DLV_ERROR);
246*f3e7f55eSRobert Mustacchi                 }
247*f3e7f55eSRobert Mustacchi                 curr_chain->ch_item = arange;
248*f3e7f55eSRobert Mustacchi                 if (head_chain == NULL)
249*f3e7f55eSRobert Mustacchi                     head_chain = prev_chain = curr_chain;
250*f3e7f55eSRobert Mustacchi                 else {
251*f3e7f55eSRobert Mustacchi                     prev_chain->ch_next = curr_chain;
252*f3e7f55eSRobert Mustacchi                     prev_chain = curr_chain;
253*f3e7f55eSRobert Mustacchi                 }
254*f3e7f55eSRobert Mustacchi 
255*f3e7f55eSRobert Mustacchi             }
256*f3e7f55eSRobert Mustacchi         }
257*f3e7f55eSRobert Mustacchi         dwarf_dealloc(dbg, frame_inst, DW_DLA_FRAME_BLOCK);
258*f3e7f55eSRobert Mustacchi 
259*f3e7f55eSRobert Mustacchi     }
260*f3e7f55eSRobert Mustacchi     dwarf_dealloc(dbg, fde_data, DW_DLA_LIST);
261*f3e7f55eSRobert Mustacchi     dwarf_dealloc(dbg, cie_data, DW_DLA_LIST);
262*f3e7f55eSRobert Mustacchi     arange_addrs = (Dwarf_Addr *)
263*f3e7f55eSRobert Mustacchi         _dwarf_get_alloc(dbg, DW_DLA_ADDR, arange_count);
264*f3e7f55eSRobert Mustacchi     if (arange_addrs == NULL) {
265*f3e7f55eSRobert Mustacchi         _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
266*f3e7f55eSRobert Mustacchi         return (DW_DLV_ERROR);
267*f3e7f55eSRobert Mustacchi     }
268*f3e7f55eSRobert Mustacchi     arange_offsets = (Dwarf_Off *)
269*f3e7f55eSRobert Mustacchi         _dwarf_get_alloc(dbg, DW_DLA_ADDR, arange_count);
270*f3e7f55eSRobert Mustacchi     if (arange_offsets == NULL) {
271*f3e7f55eSRobert Mustacchi         _dwarf_error(dbg, err, DW_DLE_ALLOC_FAIL);
272*f3e7f55eSRobert Mustacchi         return (DW_DLV_ERROR);
273*f3e7f55eSRobert Mustacchi     }
274*f3e7f55eSRobert Mustacchi 
275*f3e7f55eSRobert Mustacchi     curr_chain = head_chain;
276*f3e7f55eSRobert Mustacchi     for (i = 0; i < arange_count; i++) {
277*f3e7f55eSRobert Mustacchi         Dwarf_Arange ar = curr_chain->ch_item;
278*f3e7f55eSRobert Mustacchi 
279*f3e7f55eSRobert Mustacchi         arange_addrs[i] = ar->ar_address;
280*f3e7f55eSRobert Mustacchi         arange_offsets[i] = ar->ar_info_offset;
281*f3e7f55eSRobert Mustacchi         prev_chain = curr_chain;
282*f3e7f55eSRobert Mustacchi         curr_chain = curr_chain->ch_next;
283*f3e7f55eSRobert Mustacchi         dwarf_dealloc(dbg, ar, DW_DLA_ARANGE);
284*f3e7f55eSRobert Mustacchi         dwarf_dealloc(dbg, prev_chain, DW_DLA_CHAIN);
285*f3e7f55eSRobert Mustacchi     }
286*f3e7f55eSRobert Mustacchi     *returncount = arange_count;
287*f3e7f55eSRobert Mustacchi     *offsetlist = arange_offsets;
288*f3e7f55eSRobert Mustacchi     *addrlist = arange_addrs;
289*f3e7f55eSRobert Mustacchi     return retval;
290*f3e7f55eSRobert Mustacchi }
291