2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * The contents of this file constitute Original Code as defined in and
7 * are subject to the Apple Public Source License Version 1.1 (the
8 * "License"). You may not use this file except in compliance with the
9 * License. Please obtain a copy of the License at
10 * http://www.apple.com/publicsource and read it before using this file.
12 * This Original Code and all software distributed under the License are
13 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
14 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
15 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
17 * License for the specific language governing rights and limitations
20 * @APPLE_LICENSE_HEADER_END@
28 * Revision 1.1.1.1 1998/09/22 21:05:49 wsanchez
29 * Import of Mac OS X kernel (~semeria)
31 * Revision 1.1.1.1 1998/03/07 02:26:08 wsanchez
32 * Import of OSF Mach kernel (~mburg)
34 * Revision 1.1.7.1 1997/09/22 17:41:24 barbou
35 * MP+RT: protect cpu_number() usage against preemption.
38 * Revision 1.1.5.1 1995/01/06 19:53:37 devrcs
39 * mk6 CR668 - 1.3b26 merge
41 * [1994/10/12 22:25:20 dwm]
43 * Revision 1.1.2.2 1994/05/16 19:19:17 meissner
44 * Add support for converting 64-bit integers to a decimal string.
45 * Use the correct address (selfpc) when creating the prof header for gprof.
46 * [1994/04/28 21:44:59 meissner]
48 * Revision 1.1.2.1 1994/04/08 17:51:42 meissner
49 * Make most stats 64 bits, except for things like memory allocation.
50 * [1994/04/02 14:58:21 meissner]
52 * Do not provide old mcount support under MK or server.
53 * Fixup stats size so it is the same as in profile-md.h.
54 * [1994/03/29 21:00:03 meissner]
56 * Use faster sequence for overflow addition.
57 * Keep {dummy,prof,gprof,old}_mcount counts in double precision.
58 * Add kernel NCPUS > 1 support.
59 * [1994/03/17 20:13:23 meissner]
61 * Add gprof/prof overflow support
62 * [1994/03/17 14:56:44 meissner]
64 * Add size of histogram counters & unused fields to profile_profil struct
65 * [1994/02/17 21:41:44 meissner]
67 * Add too_low/too_high to profile_stats.
68 * [1994/02/16 22:38:11 meissner]
70 * Bump # allocation contexts to 32 from 16.
71 * Store unique ptr address in gprof function header structure for _profile_reset.
72 * Add new fields from profile-{internal,md}.h.
73 * Align loop looking for an unlocked acontext.
74 * Count # times a locked context block was found.
76 * [1994/02/07 12:40:56 meissner]
78 * Keep track of the number of times the kernel overflows the HISTCOUNTER counter.
79 * [1994/02/03 20:13:23 meissner]
81 * Add stats for {user,kernel,idle} mode in the kernel.
82 * [1994/02/03 15:17:22 meissner]
85 * [1994/02/03 00:58:49 meissner]
87 * Combine _profile_{vars,stats,md}; Allow more than one _profile_vars.
88 * [1994/02/01 12:03:56 meissner]
90 * Move _mcount_ptr to be closer to other data declarations.
91 * Add text_len to profile_profil structure for mk.
92 * Split records_cnt into prof_cnt/gprof_cnt.
93 * Always update prof_cnt/gprof_cnt even if not DO_STATS.
94 * Add current/max cpu indicator to stats for kernel.
95 * [1994/01/28 23:33:20 meissner]
97 * Don't do 4+Lgotoff(lab), use separate labels.
98 * Change GPROF_HASH_SHIFT to 9 (from 8).
99 * [1994/01/26 22:00:59 meissner]
101 * Fixup NO_RECURSIVE_ALLOC to do byte loads, not word loads.
102 * [1994/01/26 20:30:57 meissner]
104 * Move callback pointers into separate allocation context.
105 * Add size fields for other structures to profile-vars.
106 * Allocate string table as one large allocation.
107 * Rewrite old mcount code once again.
108 * Use multiply to make hash value, not divide.
109 * Hash table is now a power of two.
110 * [1994/01/26 20:23:32 meissner]
112 * Cut hash table size back to 16189.
113 * Add size fields to all structures.
114 * Add major/minor version number to _profile_md.
115 * Move allocation context block pointers to _profile_vars.
116 * Move _gprof_dummy after _profile_md.
117 * New function header code now falls into hash an element
118 * to avoid having the hash code duplicated or use a macro.
119 * Fix bug in _gprof_mcount with ELF shared libraries.
120 * [1994/01/25 01:45:59 meissner]
122 * Move init functions to C code; rearrange profil varaibles.
123 * [1994/01/22 01:11:14 meissner]
126 * [1994/01/20 20:56:43 meissner]
129 * [1994/01/18 23:07:39 meissner]
131 * Make flags byte-sized.
133 * Add init_format flag.
134 * Always put word size multipler first in .space.
135 * [1994/01/18 21:57:14 meissner]
137 * Fix elfpic problems in last change.
138 * [1994/01/16 14:04:26 meissner]
140 * Rewrite gprof caching to be faster & not need a lock.
141 * Record prof information for gprof too.
142 * Bump reserved stats to 64.
143 * Bump up hash table size 30799.
144 * Conditionally use lock prefix.
145 * Change most #ifdef's to #if.
146 * DEBUG_PROFILE turns on stack frames now.
147 * Conditionally add externs to gprof to determine where time is spent.
148 * Prof_mcount uses xchgl to update function pointer.
149 * [1994/01/15 18:40:33 meissner]
152 * Separate statistics from debugging (though debugging turns it on).
153 * Remove debug code that traces each gprof request.
154 * [1994/01/15 00:59:02 meissner]
156 * Move max hash bucket calculation into _gprof_write & put info in stats structure.
157 * [1994/01/04 16:15:14 meissner]
159 * Use _profile_printf to write diagnostics; add diag_stream to hold stream to write to.
160 * [1994/01/04 15:37:44 meissner]
162 * Add more allocation memory pools (gprof function hdrs in particular).
163 * For prof, gprof arc, and gprof function hdrs, allocate 16 pages at a time.
164 * Add major/minor version numbers to _profile_{vars,stats}.
165 * Add # profil buckets field to _profil_stats.
172 * Common 386 profiling module that is shared between the kernel, mach
173 * servers, and the user space library. Each environment includes
177 .file "profile-asm.s"
181 #include <machine/asm.h>
184 * By default, debugging turns on statistics and stack frames.
193 #define STACK_FRAMES 1
198 #define OLD_MCOUNT 0 /* do not compile old code for mcount */
202 #define DO_STATS 1 /* compile in statistics code */
206 #define DO_LOCK 0 /* use lock; in front of increments */
210 #define LOCK_STATS DO_LOCK /* update stats with lock set */
214 #define STACK_FRAMES 0 /* create stack frames for debugger */
217 #ifndef NO_RECURSIVE_ALLOC
218 #define NO_RECURSIVE_ALLOC 0 /* check for recursive allocs */
219 /* (not thread safe!) */
223 #define MARK_GPROF 0 /* add externs for gprof profiling */
227 #define OVERFLOW 1 /* add overflow checking support */
231 * Turn on the use of the lock prefix if desired.
251 * Double or single precision incrementing
255 #define DINC(mem) LOCK addl $1,mem; LOCK adcl $0,4+mem
256 #define DINC2(mem,mem2) LOCK addl $1,mem; LOCK adcl $0,mem2
257 #define SDINC(mem) SLOCK addl $1,mem; SLOCK adcl $0,4+mem
258 #define SDADD(val,mem) SLOCK addl val,mem; SLOCK adcl $0,4+mem
259 #define SDADDNEG(val,mem) SLOCK subl val,mem; SLOCK adcl $0,4+mem
260 #define SDSUB(val,mem) SLOCK subl val,mem; SLOCK sbbl $0,4+mem
263 #define DINC(mem) LOCK incl mem
264 #define DINC2(mem,mem2) LOCK incl mem
265 #define SDINC(mem) SLOCK incl mem
266 #define SDADD(val,mem) SLOCK addl val,mem
267 #define SDADDNEG(val,mem) SLOCK subl val,mem
268 #define SDSUB(val,mem) SLOCK subl val,mem
272 * Stack frame support so that debugger traceback works.
276 #define ENTER pushl %ebp; movl %esp,%ebp
277 #define LEAVE0 popl %ebp
290 #define MARK(name) .globl EXT(name); ELF_FUNC(EXT(name)); ELF_SIZE(EXT(name),0); LEXT(name)
296 * Profiling allocation context block. Each time memory is needed, the
297 * allocator loops until it finds an unlocked context block, and allocates
298 * from that block. If no context blocks are available, a new memory
299 * pool is allocated, and added to the end of the chain.
302 LCL(A_next) = 0 /* next context block link (must be 0) */
303 LCL(A_plist) = LCL(A_next)+4 /* head of page list for context block */
304 LCL(A_lock) = LCL(A_plist)+4 /* lock word */
305 LCL(A_size) = LCL(A_lock)+4 /* size of context block */
307 #define A_next LCL(A_next)
308 #define A_plist LCL(A_plist)
309 #define A_lock LCL(A_lock)
310 #define A_size LCL(A_size)
313 * Allocation contexts used.
316 LCL(C_prof) = 0 /* prof records */
317 LCL(C_gprof) = 1 /* gprof arc records */
318 LCL(C_gfunc) = 2 /* gprof function headers */
319 LCL(C_misc) = 3 /* misc. allocations */
320 LCL(C_profil) = 4 /* memory for profil */
321 LCL(C_dci) = 5 /* memory for dci */
322 LCL(C_bb) = 6 /* memory for basic blocks */
323 LCL(C_callback) = 7 /* memory for callbacks */
324 LCL(C_max) = 32 /* # allocation contexts */
326 #define C_prof LCL(C_prof)
327 #define C_gprof LCL(C_gprof)
328 #define C_gfunc LCL(C_gfunc)
329 #define C_max LCL(C_max)
332 * Linked list of memory allocations.
335 LCL(M_first) = 0 /* pointer to first byte available */
336 LCL(M_ptr) = LCL(M_first)+4 /* pointer to next available byte */
337 LCL(M_next) = LCL(M_ptr)+4 /* next page allocated */
338 LCL(M_nfree) = LCL(M_next)+4 /* # bytes available */
339 LCL(M_nalloc) = LCL(M_nfree)+4 /* # bytes allocated */
340 LCL(M_num) = LCL(M_nalloc)+4 /* # allocations done on this page */
341 LCL(M_size) = LCL(M_num)+4 /* size of page header */
343 #define M_first LCL(M_first)
344 #define M_ptr LCL(M_ptr)
345 #define M_next LCL(M_next)
346 #define M_nfree LCL(M_nfree)
347 #define M_nalloc LCL(M_nalloc)
348 #define M_num LCL(M_num)
349 #define M_size LCL(M_size)
355 LCL(P_addr) = 0 /* function address */
356 LCL(P_count) = LCL(P_addr)+4 /* # times function called */
357 LCL(P_overflow) = LCL(P_count)+4 /* # times count overflowed */
358 LCL(P_size) = LCL(P_overflow)+4 /* size of prof data type */
360 #define P_addr LCL(P_addr)
361 #define P_count LCL(P_count)
362 #define P_overflow LCL(P_overflow)
363 #define P_size LCL(P_size)
369 LCL(G_next) = 0 /* next hash link (must be 0) */
370 LCL(G_frompc) = LCL(G_next)+4 /* caller's caller */
371 LCL(G_selfpc) = LCL(G_frompc)+4 /* caller's address */
372 LCL(G_count) = LCL(G_selfpc)+4 /* # times arc traversed */
373 LCL(G_overflow) = LCL(G_count)+4 /* # times count overflowed */
374 LCL(G_size) = LCL(G_overflow)+4 /* size of gprof data type */
376 #define G_next LCL(G_next)
377 #define G_frompc LCL(G_frompc)
378 #define G_selfpc LCL(G_selfpc)
379 #define G_count LCL(G_count)
380 #define G_overflow LCL(G_overflow)
381 #define G_size LCL(G_size)
386 * At least one header is allocated for each unique function that is profiled.
387 * In order to save time calculating the hash value, the last H_maxcache
388 * distinct arcs are cached within this structure. Also, to avoid loading
389 * the GOT when searching the hash table, we copy the hash pointer to this
390 * structure, so that we only load the GOT when we need to allocate an arc.
393 LCL(H_maxcache) = 3 /* # of cache table entries */
394 LCL(H_csize) = 4*LCL(H_maxcache) /* size of each cache array */
396 LCL(H_hash_ptr) = 0 /* hash table to use */
397 LCL(H_unique_ptr) = LCL(H_hash_ptr)+4 /* function unique pointer */
398 LCL(H_prof) = LCL(H_unique_ptr)+4 /* prof statistics */
399 LCL(H_cache_ptr) = LCL(H_prof)+P_size /* cache table of element pointers */
400 LCL(H_size) = LCL(H_cache_ptr)+LCL(H_csize) /* size of gprof header type */
402 #define H_maxcache LCL(H_maxcache)
403 #define H_csize LCL(H_csize)
404 #define H_hash_ptr LCL(H_hash_ptr)
405 #define H_unique_ptr LCL(H_unique_ptr)
406 #define H_prof LCL(H_prof)
407 #define H_cache_ptr LCL(H_cache_ptr)
408 #define H_size LCL(H_size)
411 * Number of digits needed to write a 64 bit number including trailing null.
412 * (rounded up to be divisable by 4).
421 * Default gprof hash table size, which must be a power of two.
422 * The shift specifies how many low order bits to eliminate when
423 * calculating the hash value.
426 #ifndef GPROF_HASH_SIZE
427 #define GPROF_HASH_SIZE 16384
430 #ifndef GPROF_HASH_SHIFT
431 #define GPROF_HASH_SHIFT 9
434 #define GPROF_HASH_MASK (GPROF_HASH_SIZE-1)
436 DATA(_profile_hash_size)
437 .long GPROF_HASH_SIZE
438 ENDDATA(_profile_hash_size)
443 * Pointer that the compiler uses to call to the appropriate mcount function.
447 .long EXT(_dummy_mcount)
451 * Global profile variables. The structure that accesses this in C is declared
452 * in profile-internal.h. All items in .data that follow this will be used as
453 * one giant record, and each unique machine, thread, kgmon output or what have
454 * you will create a separate instance. Typically there is only one instance
455 * which will be the memory laid out below.
458 LCL(var_major_version) = 0 /* major version number */
459 LCL(var_minor_version) = LCL(var_major_version)+4 /* minor version number */
460 LCL(vars_size) = LCL(var_minor_version)+4 /* size of _profile_vars structure */
461 LCL(plist_size) = LCL(vars_size)+4 /* size of page_list structure */
462 LCL(acontext_size) = LCL(plist_size)+4 /* size of allocation contexts */
463 LCL(callback_size) = LCL(acontext_size)+4 /* size of callback structure */
464 LCL(type) = LCL(callback_size)+4 /* profile type (gprof, prof) */
465 LCL(error_msg) = LCL(type)+4 /* error message for perror */
466 LCL(filename) = LCL(error_msg)+4 /* filename to write to */
467 LCL(str_ptr) = LCL(filename)+4 /* string table pointer */
468 LCL(stream) = LCL(str_ptr)+4 /* stdio stream to write to */
469 LCL(diag_stream) = LCL(stream)+4 /* stdio stream to write diagnostics to */
470 LCL(fwrite_func) = LCL(diag_stream)+4 /* function like fwrite to output bytes */
471 LCL(page_size) = LCL(fwrite_func)+4 /* page size in bytes */
472 LCL(str_bytes) = LCL(page_size)+4 /* # bytes in string table */
473 LCL(str_total) = LCL(str_bytes)+4 /* # total bytes allocated for string table */
474 LCL(clock_ticks) = LCL(str_total)+4 /* # clock ticks per second */
476 /* profil variables */
477 LCL(profil_start) = LCL(clock_ticks)+4 /* start of profil variables */
478 LCL(lowpc) = LCL(clock_ticks)+4 /* lowest address */
479 LCL(highpc) = LCL(lowpc)+4 /* highest address */
480 LCL(text_len) = LCL(highpc)+4 /* highpc-lowpc */
481 LCL(profil_len) = LCL(text_len)+4 /* size of profil buffer */
482 LCL(counter_size) = LCL(profil_len)+4 /* size of indivual counter */
483 LCL(scale) = LCL(counter_size)+4 /* scale factor */
484 LCL(profil_unused) = LCL(scale)+4 /* unused fields */
485 LCL(profil_end) = LCL(profil_unused)+4*8 /* end of profil_info structure */
486 LCL(profil_buf) = LCL(profil_end) /* buffer for profil */
488 /* Output selection func ptrs */
489 LCL(output_init) = LCL(profil_buf)+4 /* Initialization */
490 LCL(output) = LCL(output_init)+4 /* Write out profiling info */
491 LCL(output_ptr) = LCL(output)+4 /* Output specific data ptr */
493 /* Memory allocation support */
494 LCL(acontext) = LCL(output_ptr)+4 /* pointers to allocation context blocks */
496 LCL(bogus_func) = LCL(acontext)+4*C_max /* function to use if gprof arc is bad */
497 LCL(vars_unused) = LCL(bogus_func)+4 /* future growth */
500 LCL(init) = LCL(vars_unused)+4*63 /* whether initializations were done */
501 LCL(active) = LCL(init)+1 /* whether profiling is active */
502 LCL(do_profile) = LCL(active)+1 /* whether to do profiling */
503 LCL(use_dci) = LCL(do_profile)+1 /* whether to use DCI */
504 LCL(use_profil) = LCL(use_dci)+1 /* whether to use profil */
505 LCL(recursive_alloc) = LCL(use_profil)+1 /* alloc called recursively */
506 LCL(output_uarea) = LCL(recursive_alloc)+1 /* output uarea */
507 LCL(output_stats) = LCL(output_uarea)+1 /* output stats info */
508 LCL(output_clock) = LCL(output_stats)+1 /* output the clock ticks */
509 LCL(multiple_sections) = LCL(output_clock)+1 /* multiple sections are ok */
510 LCL(have_bb) = LCL(multiple_sections)+1 /* whether we have basic block data */
511 LCL(init_format) = LCL(have_bb)+1 /* The output format has been chosen */
512 LCL(debug) = LCL(init_format)+1 /* Whether or not we are debugging */
513 LCL(check_funcs) = LCL(debug)+1 /* Whether to check functions for validity */
514 LCL(flag_unused) = LCL(check_funcs)+1 /* unused flags */
515 LCL(end_of_vars) = LCL(flag_unused)+62 /* size of machine independent vars */
518 * Data that contains profile statistics that can be dumped out
519 * into the {,g}mon.out file. This is defined in profile-md.h.
522 LCL(stats_start) = LCL(end_of_vars) /* start of stats substructure */
523 LCL(stats_major_version)= LCL(stats_start) /* major version number */
524 LCL(stats_minor_version)= LCL(stats_major_version)+4 /* minor version number */
525 LCL(stats_size) = LCL(stats_minor_version)+4 /* size of _profile_stats structure */
526 LCL(profil_buckets) = LCL(stats_size)+4 /* # profil buckets */
527 LCL(my_cpu) = LCL(profil_buckets)+4 /* identify which cpu/thread this is */
528 LCL(max_cpu) = LCL(my_cpu)+4 /* identify which cpu/thread this is */
529 LCL(prof_records) = LCL(max_cpu)+4 /* # of profiled functions */
530 LCL(gprof_records) = LCL(prof_records)+4 /* # of gprof arcs created */
531 LCL(hash_buckets) = LCL(gprof_records)+4 /* max gprof hash buckets on a chain */
532 LCL(bogus_count) = LCL(hash_buckets)+4 /* # bogus functions found in gprof */
534 LCL(cnt) = LCL(bogus_count)+4 /* # of _{prof,gprof}_mcount calls */
535 LCL(dummy) = LCL(cnt)+8 /* # of _dummy_mcount calls */
536 LCL(old_mcount) = LCL(dummy)+8 /* # of old mcount calls */
537 LCL(hash_search) = LCL(old_mcount)+8 /* # gprof hash buckets searched */
538 LCL(hash_num) = LCL(hash_search)+8 /* # times hash table searched */
539 LCL(user_ticks) = LCL(hash_num)+8 /* # ticks within user space */
540 LCL(kernel_ticks) = LCL(user_ticks)+8 /* # ticks within kernel space */
541 LCL(idle_ticks) = LCL(kernel_ticks)+8 /* # ticks cpu was idle */
542 LCL(overflow_ticks) = LCL(idle_ticks)+8 /* # ticks where histcounter overflowed */
543 LCL(acontext_locked) = LCL(overflow_ticks)+8 /* # times an acontext was locked */
544 LCL(too_low) = LCL(acontext_locked)+8 /* # times histogram tick too low */
545 LCL(too_high) = LCL(too_low)+8 /* # times histogram tick too low */
546 LCL(prof_overflow) = LCL(too_high)+8 /* # times the prof count field overflowed */
547 LCL(gprof_overflow) = LCL(prof_overflow)+8 /* # times the gprof count field overflowed */
548 LCL(num_alloc) = LCL(gprof_overflow)+8 /* # allocations in each context */
549 LCL(bytes_alloc) = LCL(num_alloc)+4*C_max /* bytes allocated in each context */
550 LCL(num_context) = LCL(bytes_alloc)+4*C_max /* # allocation context blocks */
551 LCL(wasted) = LCL(num_context)+4*C_max /* # bytes wasted */
552 LCL(overhead) = LCL(wasted)+4*C_max /* # bytes of overhead */
553 LCL(buckets) = LCL(overhead)+4*C_max /* # hash indexes that have n buckets */
554 LCL(cache_hits1) = LCL(buckets)+4*10 /* # gprof cache hits in bucket #1 */
555 LCL(cache_hits2) = LCL(cache_hits1)+8 /* # gprof cache hits in bucket #2 */
556 LCL(cache_hits3) = LCL(cache_hits2)+8 /* # gprof cache hits in bucket #3 */
557 LCL(stats_unused) = LCL(cache_hits3)+8 /* reserved for future use */
558 LCL(stats_end) = LCL(stats_unused)+8*64 /* end of stats structure */
561 * Machine dependent variables that no C file should access (except for
565 LCL(md_start) = LCL(stats_end) /* start of md structure */
566 LCL(md_major_version) = LCL(md_start) /* major version number */
567 LCL(md_minor_version) = LCL(md_major_version)+4 /* minor version number */
568 LCL(md_size) = LCL(md_minor_version)+4 /* size of _profile_stats structure */
569 LCL(hash_ptr) = LCL(md_size)+4 /* gprof hash pointer */
570 LCL(hash_size) = LCL(hash_ptr)+4 /* gprof hash size */
571 LCL(num_cache) = LCL(hash_size)+4 /* # of cache entries */
572 LCL(save_mcount_ptr) = LCL(num_cache)+4 /* save for mcount_ptr when suspending profiling */
573 LCL(mcount_ptr_ptr) = LCL(save_mcount_ptr)+4 /* pointer to _mcount_ptr */
574 LCL(dummy_ptr) = LCL(mcount_ptr_ptr)+4 /* pointer to gprof_dummy */
575 LCL(alloc_pages) = LCL(dummy_ptr)+4 /* allocate more memory */
576 LCL(num_buffer) = LCL(alloc_pages)+4 /* buffer to convert 64 bit ints in */
577 LCL(md_unused) = LCL(num_buffer)+N_digit /* unused fields */
578 LCL(md_end) = LCL(md_unused)+4*58 /* end of md structure */
579 LCL(total_size) = LCL(md_end) /* size of entire structure */
582 * Size of the entire _profile_vars structure.
586 .long LCL(total_size)
587 ENDDATA(_profile_size)
590 * Size of the statistics substructure.
593 DATA(_profile_stats_size)
594 .long LCL(stats_end)-LCL(stats_start)
595 ENDDATA(_profile_stats_size)
598 * Size of the profil info substructure.
601 DATA(_profile_profil_size)
602 .long LCL(profil_end)-LCL(profil_start)
603 ENDDATA(_profile_profil_size)
606 * Size of the machine dependent substructure.
609 DATA(_profile_md_size)
610 .long LCL(md_end)-LCL(md_start)
611 ENDDATA(_profile_profil_size)
614 * Whether statistics are supported.
617 DATA(_profile_do_stats)
619 ENDDATA(_profile_do_stats)
624 * Map LCL(xxx) -> into simpler names
627 #define V_acontext LCL(acontext)
628 #define V_acontext_locked LCL(acontext_locked)
629 #define V_alloc_pages LCL(alloc_pages)
630 #define V_bogus_func LCL(bogus_func)
631 #define V_bytes_alloc LCL(bytes_alloc)
632 #define V_cache_hits1 LCL(cache_hits1)
633 #define V_cache_hits2 LCL(cache_hits2)
634 #define V_cache_hits3 LCL(cache_hits3)
635 #define V_cnt LCL(cnt)
636 #define V_cnt_overflow LCL(cnt_overflow)
637 #define V_check_funcs LCL(check_funcs)
638 #define V_dummy LCL(dummy)
639 #define V_dummy_overflow LCL(dummy_overflow)
640 #define V_dummy_ptr LCL(dummy_ptr)
641 #define V_gprof_records LCL(gprof_records)
642 #define V_hash_num LCL(hash_num)
643 #define V_hash_ptr LCL(hash_ptr)
644 #define V_hash_search LCL(hash_search)
645 #define V_mcount_ptr_ptr LCL(mcount_ptr_ptr)
646 #define V_num_alloc LCL(num_alloc)
647 #define V_num_buffer LCL(num_buffer)
648 #define V_num_context LCL(num_context)
649 #define V_old_mcount LCL(old_mcount)
650 #define V_old_mcount_overflow LCL(old_mcount_overflow)
651 #define V_overhead LCL(overhead)
652 #define V_page_size LCL(page_size)
653 #define V_prof_records LCL(prof_records)
654 #define V_recursive_alloc LCL(recursive_alloc)
655 #define V_wasted LCL(wasted)
658 * Loadup %ebx with the address of _profile_vars. On a multiprocessor, this
659 * will loads up the appropriate machine's _profile_vars structure.
660 * For ELF shared libraries, rely on the fact that we won't need a GOT,
661 * except to load this pointer.
664 #if defined (MACH_KERNEL) && NCPUS > 1
669 #include <i386/SQT/asm_macros.h>
673 #error "Cannot determine how to get CPU number"
676 #define Vload CPU_NUMBER(%ebx); movl EXT(_profile_vars_cpus)(,%ebx,4),%ebx
678 #else /* not kernel or not multiprocessor */
679 #define Vload Gload; Egaddr(%ebx,_profile_vars)
684 * Allocate some memory for profiling. This memory is guaranteed to
686 * %eax contains the memory size requested and will contain ptr on exit.
687 * %ebx contains the address of the appropriate profile_vars structure.
688 * %ecx is the number of the memory pool to allocate from (trashed on exit).
695 Entry(_profile_alloc_asm)
700 movl %ecx,%edi /* move context number to saved reg */
702 #if NO_RECURSIVE_ALLOC
704 xchgb %cl,V_recursive_alloc(%ebx)
714 leal V_acontext(%ebx,%edi,4),%ecx
716 /* Loop looking for a free allocation context. */
717 /* %eax = size, %ebx = vars addr, %ecx = ptr to allocation context to try */
718 /* %edi = context number */
722 movl %ecx,%esi /* save ptr in case no more contexts */
723 movl A_next(%ecx),%ecx /* next context block */
725 je LCL(alloc_context) /* need to allocate a new context block */
728 xchgl %edx,A_lock(%ecx) /* %edx == 0 if context available */
731 SDADDNEG(%edx,V_acontext_locked(%ebx)) /* increment counter if lock was held */
735 jne LCL(alloc_loop) /* go back if this context block is not available */
737 /* Allocation context found (%ecx), now allocate. */
738 movl A_plist(%ecx),%edx /* pointer to current block */
739 cmpl $0,%edx /* first allocation? */
742 cmpl %eax,M_nfree(%edx) /* see if we have enough space */
743 jl LCL(alloc_new) /* jump if not enough space */
745 /* Allocate from local block (and common exit) */
746 /* %eax = bytes to allocate, %ebx = GOT, %ecx = context, %edx = memory block */
747 /* %edi = context number */
753 SLOCK incl V_num_alloc(%ebx,%edi,4) /* update global counters */
754 SLOCK addl %eax,V_bytes_alloc(%ebx,%edi,4)
755 SLOCK subl %eax,V_wasted(%ebx,%edi,4)
758 movl M_ptr(%edx),%esi /* pointer return value */
759 subl %eax,M_nfree(%edx) /* decrement bytes remaining */
760 addl %eax,M_nalloc(%edx) /* increment bytes allocated */
761 incl M_num(%edx) /* increment # allocations */
762 addl %eax,M_ptr(%edx) /* advance pointer */
763 movl $0,A_lock(%ecx) /* unlock context block */
764 movl %esi,%eax /* return pointer */
766 #if NO_RECURSIVE_ALLOC
767 movb $0,V_recursive_alloc(%ebx)
773 ret /* return to the caller */
775 /* Allocate space in whole number of pages */
776 /* %eax = bytes to allocate, %ebx = vars address, %ecx = context */
777 /* %edi = context number */
781 pushl %eax /* save regs */
783 movl V_page_size(%ebx),%edx
784 addl $(M_size-1),%eax /* add in overhead size & subtract 1 */
785 decl %edx /* page_size - 1 */
786 addl %edx,%eax /* round up to whole number of pages */
789 leal -M_size(%eax),%esi /* save allocation size */
790 pushl %eax /* argument to _profile_alloc_pages */
791 call *V_alloc_pages(%ebx) /* allocate some memory */
792 addl $4,%esp /* pop off argument */
795 SLOCK addl %esi,V_wasted(%ebx,%edi,4) /* udpate global counters */
796 SLOCK addl $(M_size),V_overhead(%ebx,%edi,4)
799 popl %ecx /* context block */
800 movl %eax,%edx /* memory block pointer */
801 movl %esi,M_nfree(%edx) /* # free bytes */
802 addl $(M_size),%eax /* bump past overhead */
803 movl A_plist(%ecx),%esi /* previous memory block or 0 */
804 movl %eax,M_first(%edx) /* first space available */
805 movl %eax,M_ptr(%edx) /* current address available */
806 movl %esi,M_next(%edx) /* next memory block allocated */
807 movl %edx,A_plist(%ecx) /* update current page list */
808 popl %eax /* user size request */
809 jmp LCL(alloc_ret) /* goto common return code */
811 /* Allocate a context header in addition to memory block header + data */
812 /* %eax = bytes to allocate, %ebx = GOT, %esi = ptr to store context ptr */
813 /* %edi = context number */
817 pushl %eax /* save regs */
819 movl V_page_size(%ebx),%edx
820 addl $(A_size+M_size-1),%eax /* add in overhead size & subtract 1 */
821 decl %edx /* page_size - 1 */
822 addl %edx,%eax /* round up to whole number of pages */
825 leal -A_size-M_size(%eax),%esi /* save allocation size */
826 pushl %eax /* argument to _profile_alloc_pages */
827 call *V_alloc_pages(%ebx) /* allocate some memory */
828 addl $4,%esp /* pop off argument */
831 SLOCK incl V_num_context(%ebx,%edi,4) /* bump # context blocks */
832 SLOCK addl %esi,V_wasted(%ebx,%edi,4) /* update global counters */
833 SLOCK addl $(A_size+M_size),V_overhead(%ebx,%edi,4)
836 movl %eax,%ecx /* context pointer */
837 leal A_size(%eax),%edx /* memory block pointer */
838 movl %esi,M_nfree(%edx) /* # free bytes */
839 addl $(A_size+M_size),%eax /* bump past overhead */
840 movl %eax,M_first(%edx) /* first space available */
841 movl %eax,M_ptr(%edx) /* current address available */
842 movl $0,M_next(%edx) /* next memory block allocated */
843 movl %edx,A_plist(%ecx) /* head of memory block list */
844 movl $1,A_lock(%ecx) /* set lock */
845 popl %esi /* ptr to store context block link */
846 movl %ecx,%eax /* context pointer temp */
847 xchgl %eax,A_next(%esi) /* link into chain */
848 movl %eax,A_next(%ecx) /* add links in case of threading */
849 popl %eax /* user size request */
850 jmp LCL(alloc_ret) /* goto common return code */
852 END(_profile_alloc_asm)
855 * C callable version of the profile memory allocator.
856 * extern void *_profile_alloc(struct profile_vars *, size_t, acontext_type_t);
859 Entry(_profile_alloc)
862 movl 12+Estack(%esp),%eax /* memory size */
863 movl 8+Estack(%esp),%ebx /* provile_vars address */
864 addl $3,%eax /* round up to word boundary */
865 movl 16+Estack(%esp),%ecx /* which memory pool to allocate from */
866 andl $0xfffffffc,%eax
867 call EXT(_profile_alloc_asm)
875 * Dummy mcount routine that just returns.
877 * +-------------------------------+
880 * | caller's caller stack, |
881 * | saved registers, params. |
884 * +-------------------------------+
885 * | caller's caller return addr. |
886 * +-------------------------------+
887 * esp --> | caller's return address |
888 * +-------------------------------+
890 * edx --> function unqiue LCL
898 MP_DISABLE_PREEMPTION(%ebx)
901 MP_ENABLE_PREEMPTION(%ebx)
911 * Entry point for System V based profiling, count how many times each function
912 * is called. The function label is passed in %edx, and the top two words on
913 * the stack are the caller's address, and the caller's return address.
915 * +-------------------------------+
918 * | caller's caller stack, |
919 * | saved registers, params. |
922 * +-------------------------------+
923 * | caller's caller return addr. |
924 * +-------------------------------+
925 * esp --> | caller's return address |
926 * +-------------------------------+
928 * edx --> function unique label
930 * We don't worry about the possibility about two threads calling
931 * the same function for the first time simulataneously. If that
932 * happens, two records will be created, and one of the records
933 * address will be stored in in the function unique label (which
934 * is aligned by the compiler, so we don't have to watch out for
935 * crossing page/cache boundaries).
943 MP_DISABLE_PREEMPTION(%ebx)
948 movl (%edx),%eax /* initialized? */
952 DINC2(P_count(%eax),P_overflow(%eax)) /* bump function count (double precision) */
955 MP_ENABLE_PREEMPTION(%ebx)
967 MP_DISABLE_PREEMPTION(%ebx)
971 SLOCK incl V_prof_records(%ebx)
973 movl $(P_size),%eax /* allocation size */
974 movl $(C_prof),%ecx /* allocation pool */
975 call EXT(_profile_alloc_asm) /* allocate a new record */
978 movl Estack+4(%esp),%ecx /* caller's address */
979 movl %ecx,P_addr(%eax)
980 movl $1,P_count(%eax) /* call count */
981 xchgl %eax,(%edx) /* update function header */
982 MP_ENABLE_PREEMPTION(%ebx)
991 * Entry point for BSD based graph profiling, count how many times each unique
992 * call graph (caller + callee) is called. The function label is passed in
993 * %edx, and the top two words on the stack are the caller's address, and the
994 * caller's return address.
996 * +-------------------------------+
999 * | caller's caller stack, |
1000 * | saved registers, params. |
1003 * +-------------------------------+
1004 * | caller's caller return addr. |
1005 * +-------------------------------+
1006 * esp --> | caller's return address |
1007 * +-------------------------------+
1009 * edx --> function unqiue label
1011 * We don't worry about the possibility about two threads calling the same
1012 * function simulataneously. If that happens, two records will be created, and
1013 * one of the records address will be stored in in the function unique label
1014 * (which is aligned by the compiler).
1016 * By design, the gprof header is not locked. Each of the cache pointers is
1017 * always a valid pointer (possibily to a null record), and if another thread
1018 * comes in and modifies the pointer, it does so automatically with a simple store.
1019 * Since all arcs are in the hash table, the caches are just to avoid doing
1020 * a multiplication in the common case, and if they don't match, the arcs will
1024 Entry(_gprof_mcount)
1027 movl Estack+4(%esp),%ecx /* caller's caller address */
1031 MP_DISABLE_PREEMPTION(%ebx)
1033 SDINC(V_cnt(%ebx)) /* bump profile call counter (double int) */
1036 movl (%edx),%eax /* Gprof header allocated? */
1038 je LCL(gnew) /* skip if first call */
1040 DINC2(H_prof+P_count(%eax),H_prof+P_overflow(%eax)) /* bump function count */
1042 /* See if this call arc is the same as the last time */
1043 MARK(_gprof_mcount_cache1)
1044 movl H_cache_ptr(%eax),%edx /* last arc searched */
1045 cmpl %ecx,G_frompc(%edx) /* skip if not equal */
1048 /* Same as last time, increment and return */
1050 DINC2(G_count(%edx),G_overflow(%edx)) /* bump arc count */
1053 SDINC(V_cache_hits1(%ebx)) /* update counter */
1054 MP_ENABLE_PREEMPTION(%ebx)
1061 /* Search second cache entry */
1062 /* %eax = gprof func header, %ebx = vars address if DO_STATS, %ecx = caller's caller */
1063 /* %edx = first arc searched */
1064 /* %ebx if DO_STATS pushed on stack */
1067 MARK(_gprof_mcount_cache2)
1069 pushl %esi /* get a saved register */
1070 movl H_cache_ptr+4(%eax),%esi /* 2nd arc to be searched */
1071 cmpl %ecx,G_frompc(%esi) /* skip if not equal */
1074 /* Element found, increment, reset last arc searched and return */
1076 DINC2(G_count(%esi),G_overflow(%esi)) /* bump arc count */
1078 movl %esi,H_cache_ptr+0(%eax) /* swap 1st and 2nd cached arcs */
1080 movl %edx,H_cache_ptr+4(%eax)
1083 SDINC(V_cache_hits2(%ebx)) /* update counter */
1084 MP_ENABLE_PREEMPTION(%ebx)
1091 /* Search third cache entry */
1092 /* %eax = gprof func header, %ebx = vars address if DO_STATS, %ecx = caller's caller */
1093 /* %edx = first arc searched, %esi = second arc searched */
1094 /* %esi, %ebx if DO_STATS pushed on stack */
1097 MARK(_gprof_mcount_cache3)
1100 movl H_cache_ptr+8(%eax),%edi /* 3rd arc to be searched */
1101 cmpl %ecx,G_frompc(%edi) /* skip if not equal */
1104 /* Element found, increment, reset last arc searched and return */
1106 DINC2(G_count(%edi),G_overflow(%edi)) /* bump arc count */
1108 movl %edi,H_cache_ptr+0(%eax) /* make this 1st cached arc */
1109 movl %esi,H_cache_ptr+8(%eax)
1110 movl %edx,H_cache_ptr+4(%eax)
1115 SDINC(V_cache_hits3(%ebx)) /* update counter */
1116 MP_ENABLE_PREEMPTION(%ebx)
1123 /* No function context, allocate a new context */
1124 /* %ebx is the variables address if DO_STATS */
1125 /* %ecx is the caller's caller's address */
1126 /* %edx is the unique function pointer */
1127 /* %ebx if DO_STATS pushed on stack */
1130 MARK(_gprof_mcount_new)
1136 pushl %ebx /* Address of vars needed for alloc */
1137 MP_DISABLE_PREEMPTION(%ebx)
1138 Vload /* stats already loaded address */
1141 SLOCK incl V_prof_records(%ebx)
1142 movl %edx,%esi /* save unique function ptr */
1143 movl %ecx,%edi /* and caller's caller address */
1144 movl $(H_size),%eax /* memory block size */
1145 movl $(C_gfunc),%ecx /* gprof function header memory pool */
1146 call EXT(_profile_alloc_asm)
1148 movl V_hash_ptr(%ebx),%ecx /* copy hash_ptr to func header */
1149 movl V_dummy_ptr(%ebx),%edx /* dummy cache entry */
1150 movl %ecx,H_hash_ptr(%eax)
1151 movl %edx,H_cache_ptr+0(%eax) /* store dummy cache ptrs */
1152 movl %edx,H_cache_ptr+4(%eax)
1153 movl %edx,H_cache_ptr+8(%eax)
1154 movl %esi,H_unique_ptr(%eax) /* remember function unique ptr */
1155 movl Estack+12(%esp),%ecx /* caller's address */
1156 movl $1,H_prof+P_count(%eax) /* function called once so far */
1157 movl %ecx,H_prof+P_addr(%eax) /* set up prof information */
1158 movl %eax,(%esi) /* update context block address */
1159 movl %edi,%ecx /* caller's caller address */
1160 movl %edx,%esi /* 2nd cached arc */
1166 /* Fall through to add element to the hash table. This may involve */
1167 /* searching a few hash table elements that don't need to be searched */
1168 /* since we have a new element, but it allows the hash table function */
1169 /* to be specified in only one place */
1171 /* Didn't find entry in cache, search the global hash table */
1172 /* %eax = gprof func header, %ebx = vars address if DO_STATS */
1173 /* %ecx = caller's caller */
1174 /* %edx, %esi = cached arcs that were searched */
1175 /* %edi, %esi, %ebx if DO_STATS pushed on stack */
1178 MARK(_gprof_mcount_hash)
1181 pushl %esi /* save 2nd arc searched */
1182 pushl %edx /* save 1st arc searched */
1183 movl %eax,%esi /* save gprof func header */
1186 SDINC(V_hash_num(%ebx))
1187 movl Estack+20(%esp),%edi /* caller's address */
1189 movl Estack+16(%esp),%edi /* caller's address */
1191 movl %ecx,%eax /* caller's caller address */
1192 imull %edi,%eax /* multiply to get hash */
1193 movl H_hash_ptr(%esi),%edx /* hash pointer */
1194 shrl $(GPROF_HASH_SHIFT),%eax /* eliminate low order bits */
1195 andl $(GPROF_HASH_MASK),%eax /* mask to get hash value */
1196 leal 0(%edx,%eax,4),%eax /* pointer to hash bucket */
1197 movl %eax,%edx /* save hash bucket address */
1199 /* %eax = old arc, %ebx = vars address if DO_STATS, %ecx = caller's caller */
1200 /* %edx = hash bucket address, %esi = gfunc ptr, %edi = caller's addr */
1201 /* 2 old arcs, %edi, %esi, %ebx if DO_STATS pushed on stack */
1205 movl G_next(%eax),%eax /* get next hash element */
1206 cmpl $0,%eax /* end of line? */
1207 je LCL(ghashnew) /* skip if allocate new hash */
1210 SDINC(V_hash_search(%ebx))
1213 cmpl G_selfpc(%eax),%edi /* loop back if not one we want */
1216 cmpl G_frompc(%eax),%ecx /* loop back if not one we want */
1219 /* Found an entry, increment count, set up for caching, and return */
1220 /* %eax = arc, %ebx = vars address if DO_STATS, %esi = func header */
1221 /* 2 old arcs, %edi, %esi, %ebx if DO_STATS pushed on stack */
1223 DINC2(G_count(%eax),G_overflow(%eax)) /* bump arc count */
1225 popl %ecx /* previous 1st arc searched */
1226 movl %eax,H_cache_ptr+0(%esi) /* this element is now 1st arc */
1227 popl %edi /* previous 2nd arc searched */
1228 movl %ecx,H_cache_ptr+4(%esi) /* new 2nd arc to be searched */
1229 movl %edi,H_cache_ptr+8(%esi) /* new 3rd arc to be searched */
1234 MP_ENABLE_PREEMPTION(%ebx)
1239 ret /* return to user */
1241 /* Allocate new arc */
1242 /* %eax = old arc, %ebx = vars address if DO_STATS, %ecx = caller's caller */
1243 /* %edx = hash bucket address, %esi = gfunc ptr, %edi = caller's addr */
1244 /* 2 old arcs, %edi, %esi, %ebx if DO_STATS pushed on stack */
1247 MARK(_gprof_mcount_hashnew)
1251 pushl %ebx /* load address of vars if we haven't */
1252 MP_DISABLE_PREEMPTION(%ebx)
1253 Vload /* already done so */
1256 SLOCK incl V_gprof_records(%ebx)
1258 movl %ecx,%edi /* save caller's caller */
1259 movl $(G_size),%eax /* arc size */
1260 movl $(C_gprof),%ecx /* gprof memory pool */
1261 call EXT(_profile_alloc_asm)
1264 movl $1,G_count(%eax) /* set call count */
1265 movl Estack+20(%esp),%ecx /* caller's address */
1266 movl %edi,G_frompc(%eax) /* caller's caller */
1267 movl %ecx,G_selfpc(%eax)
1270 popl %ebx /* release %ebx if no stats */
1273 movl (%edx),%ecx /* first hash bucket */
1274 movl %ecx,G_next(%eax) /* update link */
1275 movl %eax,%ecx /* copy for xchgl */
1276 xchgl %ecx,(%edx) /* add to hash linked list */
1277 movl %ecx,G_next(%eax) /* update in case list changed */
1279 popl %ecx /* previous 1st arc searched */
1280 popl %edi /* previous 2nd arc searched */
1281 movl %eax,H_cache_ptr+0(%esi) /* this element is now 1st arc */
1282 movl %ecx,H_cache_ptr+4(%esi) /* new 2nd arc to be searched */
1283 movl %edi,H_cache_ptr+8(%esi) /* new 3rd arc to be searched */
1289 MP_ENABLE_PREEMPTION(%ebx)
1294 ret /* return to user */
1300 * This function assumes that neither the caller or it's caller
1301 * has not omitted the frame pointer in order to get the caller's
1302 * caller. The stack looks like the following at the time of the call:
1304 * +-------------------------------+
1307 * | caller's caller stack, |
1308 * | saved registers, params. |
1311 * +-------------------------------+
1312 * | caller's caller return addr. |
1313 * +-------------------------------+
1314 * fp --> | previous frame pointer |
1315 * +-------------------------------+
1317 * | caller's stack, saved regs, |
1320 * +-------------------------------+
1321 * sp --> | caller's return address |
1322 * +-------------------------------+
1324 * Recent versions of the compiler put the address of the pointer
1325 * sized word in %edx. Previous versions did not, but this code
1326 * does not support them.
1330 * Note that OSF/rose blew defining _mcount, since it prepends leading
1331 * underscores, and _mcount didn't have a second leading underscore. However,
1332 * some of the kernel/server functions 'know' that mcount has a leading
1333 * underscore, so we satisfy both camps.
1346 MP_DISABLE_PREEMPTION(%ebx)
1350 SDINC(V_old_mcount(%ebx))
1353 /* In calling the functions, we will actually leave 1 extra word on the */
1354 /* top of the stack, but generated code will not notice, since the function */
1355 /* uses a frame pointer */
1357 movl V_mcount_ptr_ptr(%ebx),%ecx /* address of mcount_ptr */
1358 MP_ENABLE_PREEMPTION(%ebx)
1360 movl 4(%ebp),%eax /* caller's caller return address */
1361 xchgl %eax,(%esp) /* push & get return address */
1362 pushl %eax /* push return address */
1363 jmp *(%ecx) /* go to profile the function */
1370 #if !defined(KERNEL) && !defined(MACH_KERNEL)
1373 * Convert a 64-bit integer to a string.
1374 * Arg #1 is a pointer to a string (at least 24 bytes) or NULL
1375 * Arg #2 is the low part of the 64-bit integer.
1376 * Arg #3 is the high part of the 64-bit integer.
1379 Entry(_profile_cnt_to_decimal)
1384 movl Estack+16(%esp),%ebx /* pointer or null */
1385 movl Estack+20(%esp),%edi /* low part of number */
1386 movl $10,%ecx /* divisor */
1387 cmpl $0,%ebx /* skip if pointer ok */
1388 jne LCL(cvt_nonnull)
1390 MP_DISABLE_PREEMPTION(%ebx)
1391 Vload /* get _profile_vars address */
1392 leal V_num_buffer(%ebx),%ebx /* temp buffer to use */
1396 addl $(N_digit-1),%ebx /* point string at end */
1397 movb $0,0(%ebx) /* null terminate string */
1400 movl Estack+24(%esp),%esi /* high part of number */
1401 cmpl $0,%esi /* any thing left in high part? */
1406 movl %esi,%eax /* calculate high/10 & high%10 */
1411 movl %edi,%eax /* calculate (low + (high%10)*2^32) / 10 */
1415 decl %ebx /* decrement string pointer */
1416 addl $48,%edx /* convert from 0..9 -> '0'..'9' */
1417 movb %dl,0(%ebx) /* store digit in string */
1418 cmpl $0,%esi /* any thing left in high part? */
1421 #endif /* OVERFLOW */
1425 movl %edi,%eax /* get low part into %eax */
1429 xorl %edx,%edx /* 0 */
1430 divl %ecx /* calculate next digit */
1431 decl %ebx /* decrement string pointer */
1432 addl $48,%edx /* convert from 0..9 -> '0'..'9' */
1433 movb %dl,0(%ebx) /* store digit in string */
1434 cmpl $0,%eax /* any more digits to convert? */
1437 movl %ebx,%eax /* return value */
1440 MP_ENABLE_PREEMPTION(%ebx)
1445 END(_profile_cnt_to_decimal)