Skip navigation links

Recommended Servers for MySQL

The world's most popular open source database

Contact a MySQL Representative

Login | Register

• MySQL.com
• Downloads
• Developer Zone
• Partners & Solutions
• Customer Login

• DevZone
• Documentation
• Librarian
• Articles
• Forums
• Bugs
• Forge
• Planet MySQL
• Labs

 

 

 

• Get Started with MySQL
• Development with MySQL
• PHP
• Perl
• Python
• Ruby
• Java/JDBC
• C#/.NET

The world's most popular open source database

mysql/src/5.1-dbg/storage/innobase/include/ut0ut.h File Reference

#include "univ.i"
#include <time.h>
#include <ctype.h>

Include dependency graph for ut0ut.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef time_t	ib_time_t
Functions
ulint	ut_get_high32 (ulint a)
UNIV_INLINE ulint	ut_min (ulint n1, ulint n2)
UNIV_INLINE ulint	ut_max (ulint n1, ulint n2)
UNIV_INLINE void	ut_pair_min (ulint *a, ulint *b, ulint a1, ulint b1, ulint a2, ulint b2)
UNIV_INLINE int	ut_ulint_cmp (ulint a, ulint b)
UNIV_INLINE int	ut_pair_cmp (ulint a1, ulint a2, ulint b1, ulint b2)
UNIV_INLINE ulint	ut_2pow_remainder (ulint n, ulint m)
UNIV_INLINE ulint	ut_2pow_round (ulint n, ulint m)
UNIV_INLINE ulint	ut_2_log (ulint n)
UNIV_INLINE ulint	ut_2_exp (ulint n)
ulint	ut_2_power_up (ulint n)
void	ut_ulint_sort (ulint *arr, ulint *aux_arr, ulint low, ulint high)
ulint	ut_clock (void)
ib_time_t	ut_time (void)
void	ut_usectime (ulint *sec, ulint *ms)
double	ut_difftime (ib_time_t time2, ib_time_t time1)
void	ut_print_timestamp (FILE *file)
void	ut_sprintf_timestamp (char *buf)
void	ut_sprintf_timestamp_without_extra_chars (char *buf)
void	ut_get_year_month_day (ulint *year, ulint *month, ulint *day)
ulint	ut_delay (ulint delay)
void	ut_print_buf (FILE *file, const void *buf, ulint len)
void	ut_print_filename (FILE *f, const char *name)
void	ut_print_name (FILE *f, struct trx_struct *trx, ibool table_id, const char *name)
void	ut_print_namel (FILE *f, struct trx_struct *trx, ibool table_id, const char *name, ulint namelen)
void	ut_copy_file (FILE *dest, FILE *src)

---

Typedef Documentation

typedef time_t ib_time_t

Definition at line 18 of file ut0ut.h.

---

Function Documentation

UNIV_INLINE ulint ut_2_exp

(

ulint

n

)

Referenced by mem_area_alloc(), mem_area_free(), mem_pool_create(), mem_pool_fill_free_list(), mem_pool_print_info(), and mem_pool_validate().

Here is the caller graph for this function:

UNIV_INLINE ulint ut_2_log

(

ulint

n

)

Referenced by mem_area_alloc(), mem_area_free(), and mem_pool_create().

Here is the caller graph for this function:

ulint ut_2_power_up

(

ulint

n

)

Definition at line 352 of file ut0ut.c.

References ut_ad.

Referenced by hash_create_mutexes(), and mem_area_free().

                              : first power of 2 which is >= n */
        ulint   n)      /* in: number != 0 */
{
        ulint   res;

        res = 1;

        ut_ad(n > 0);

        while (res < n) {
                res = res * 2;
        }

        return(res);
}

Here is the caller graph for this function:

UNIV_INLINE ulint ut_2pow_remainder	(	ulint	n,
		ulint	m
	)

Referenced by xdes_calc_descriptor_index().

Here is the caller graph for this function:

UNIV_INLINE ulint ut_2pow_round	(	ulint	n,
		ulint	m
	)

Referenced by xdes_calc_descriptor_page().

Here is the caller graph for this function:

ulint ut_clock

(

void

)

Definition at line 63 of file ut0ut.c.

{
        return((clock() * 1000) / CLOCKS_PER_SEC);
}

void ut_copy_file	(	FILE *	dest,
		FILE *	src
	)

Definition at line 447 of file ut0ut.c.

References buf.

Referenced by lock_print_info_summary(), and srv_printf_innodb_monitor().

                             : output file */
        FILE*   src)    /* in: input file to be appended to output */
{
        long    len = ftell(src);
        char    buf[4096];

        rewind(src);
        do {
                size_t  maxs =
                        len < (long) sizeof buf ? (size_t) len : sizeof buf;
                size_t  size = fread(buf, 1, maxs, src);
                fwrite(buf, 1, size, dest);
                len -= (long) size;
                if (size < maxs) {
                        break;
                }
        } while (len > 0);
}

Here is the caller graph for this function:

ulint ut_delay

(

ulint

delay

)

Definition at line 286 of file ut0ut.c.

References ut_always_false.

Referenced by mutex_spin_wait(), rw_lock_s_lock_spin(), and rw_lock_x_lock_func().

                              : dummy value */
        ulint   delay)  /* in: delay in microseconds on 100 MHz Pentium */
{
        ulint   i, j;

        j = 0;

        for (i = 0; i < delay * 50; i++) {
                j += i;
        }

        if (ut_always_false) {
                ut_always_false = (ibool) j;
        }

        return(j);
}

Here is the caller graph for this function:

double ut_difftime	(	ib_time_t	time2,
		ib_time_t	time1
	)

Definition at line 105 of file ut0ut.c.

Referenced by srv_lock_timeout_and_monitor_thread(), and srv_suspend_mysql_thread().

                                      : time2 - time1 expressed in seconds */
        ib_time_t       time2,  /* in: time */
        ib_time_t       time1)  /* in: time */
{
        return(difftime(time2, time1));
}

Here is the caller graph for this function:

ulint ut_get_high32

(

ulint

a

)

Definition at line 45 of file ut0ut.c.

                              : a >> 32 */
        ulint   a)      /* in: ulint */
{
        ib_longlong     i;

        i = (ib_longlong)a;

        i = i >> 32;

        return((ulint)i);
}

void ut_get_year_month_day	(	ulint *	year,
		ulint *	month,
		ulint *	day
	)

Definition at line 248 of file ut0ut.c.

References localtime_r().

                              : current year */
        ulint*  month,  /* out: month */
        ulint*  day)    /* out: day */
{
#ifdef __WIN__
        SYSTEMTIME cal_tm;

        GetLocalTime(&cal_tm);

        *year = (ulint)cal_tm.wYear;
        *month = (ulint)cal_tm.wMonth;
        *day = (ulint)cal_tm.wDay;
#else
        struct tm  cal_tm;
        struct tm* cal_tm_ptr;
        time_t     tm;

        time(&tm);

#ifdef HAVE_LOCALTIME_R
        localtime_r(&tm, &cal_tm);
        cal_tm_ptr = &cal_tm;
#else
        cal_tm_ptr = localtime(&tm);
#endif
        *year = (ulint)cal_tm_ptr->tm_year + 1900;
        *month = (ulint)cal_tm_ptr->tm_mon + 1;
        *day = (ulint)cal_tm_ptr->tm_mday;
#endif
}

Here is the call graph for this function:

UNIV_INLINE ulint ut_max	(	ulint	n1,
		ulint	n2
	)

Referenced by dict_table_add_to_cache(), mem_area_alloc(), and row_create_index_for_mysql().

Here is the caller graph for this function:

UNIV_INLINE ulint ut_min	(	ulint	n1,
		ulint	n2
	)

Referenced by btr_cur_optimistic_insert(), btr_cur_pessimistic_insert(), btr_cur_pessimistic_update(), btr_search_validate(), dtuple_convert_big_rec(), fil_extend_space_to_desired_size(), ibuf_get_merge_page_nos(), log_calc_max_ages(), os_file_set_size(), page_cur_insert_rec_write_log(), ut_strlcpy(), and ut_strlcpy_rev().

Here is the caller graph for this function:

UNIV_INLINE int ut_pair_cmp	(	ulint	a1,
		ulint	a2,
		ulint	b1,
		ulint	b2
	)

Referenced by btr_search_info_update_hash().

Here is the caller graph for this function:

UNIV_INLINE void ut_pair_min	(	ulint *	a,
		ulint *	b,
		ulint	a1,
		ulint	b1,
		ulint	a2,
		ulint	b2
	)

Referenced by page_cur_search_with_match().

Here is the caller graph for this function:

void ut_print_buf	(	FILE *	file,
		const void *	buf,
		ulint	len
	)

Definition at line 310 of file ut0ut.c.

References data.

Referenced by btr_pcur_restore_position(), buf_flush_ready_for_replace(), buf_page_print(), dfield_print_raw(), fseg_free_page_low(), fsp_alloc_free_page(), fsp_free_extent(), fsp_free_page(), mem_analyze_corruption(), mem_heap_validate_or_print(), os_fast_mutex_free(), page_cur_parse_insert_rec(), rec_print_new(), rec_print_old(), recv_report_corrupt_log(), row_fetch_print(), row_sel_convert_mysql_key_to_innobase(), trx_free(), and trx_undo_prev_version_build().

                                     : file where to print */
        const void*     buf,    /* in: memory buffer */
        ulint           len)    /* in: length of the buffer */
{
        const byte*     data;
        ulint           i;

        fprintf(file, " len %lu; hex ", len);

        for (data = (const byte*)buf, i = 0; i < len; i++) {
                fprintf(file, "%02lx", (ulong)*data++);
        }

        fputs("; asc ", file);

        data = (const byte*)buf;

        for (i = 0; i < len; i++) {
                int     c = (int) *data++;
                putc(isprint(c) ? c : ' ', file);
        }

        putc(';', file);
}

Here is the caller graph for this function:

void ut_print_filename	(	FILE *	f,
		const char *	name
	)

Definition at line 374 of file ut0ut.c.

Referenced by fil_create_new_single_table_tablespace(), fil_delete_tablespace(), fil_load_single_table_tablespaces(), fil_mutex_enter_and_prepare_for_io(), fil_node_create(), fil_open_single_table_tablespace(), fil_print_orphaned_tablespaces(), fil_rename_tablespace(), fil_rename_tablespace_in_mem(), fil_reset_too_high_lsns(), fil_space_create(), fil_space_for_table_exists_in_mem(), and fil_try_to_close_file_in_LRU().

                                     : output stream */
        const char*     name)   /* in: name to print */
{
        putc('\'', f);
        for (;;) {
                int     c = *name++;
                switch (c) {
                case 0:
                        goto done;
                case '\'':
                        putc(c, f);
                        /* fall through */
                default:
                        putc(c, f);
                }
        }
done:
        putc('\'', f);
}

Here is the caller graph for this function:

void ut_print_name	(	FILE *	f,
		struct trx_struct *	trx,
		ibool	table_id,
		const char *	name
	)

Definition at line 400 of file ut0ut.c.

References strlen(), and ut_print_namel().

Referenced by btr_page_get_father_for_rec(), dict_create_foreign_constraints_low(), dict_foreign_error_report(), dict_foreign_eval_sql(), dict_foreign_parse_drop_constraints(), dict_index_name_print(), dict_print_info_on_foreign_key_in_create_format(), dict_print_info_on_foreign_keys(), dict_table_remove_from_cache(), lock_rec_enqueue_waiting(), lock_table_enqueue_waiting(), lock_table_print(), row_build_row_ref_in_tuple(), row_create_index_for_mysql(), row_create_table_for_mysql(), row_discard_tablespace_for_mysql(), row_drop_database_for_mysql(), row_drop_table_for_mysql(), row_import_tablespace_for_mysql(), row_ins_foreign_report_add_err(), row_ins_foreign_report_err(), row_ins_set_detailed(), row_insert_for_mysql(), row_prebuilt_free(), row_rename_table_for_mysql(), row_search_for_mysql(), row_truncate_table_for_mysql(), row_update_for_mysql(), row_update_prebuilt_trx(), trx_rollback_or_clean_all_without_sess(), trx_rollback_to_savepoint_for_mysql(), and trx_undo_update_rec_get_update().

                                     : output stream */
        trx_t*          trx,    /* in: transaction */
        ibool           table_id,/* in: TRUE=print a table name,
                                FALSE=print other identifier */
        const char*     name)   /* in: name to print */
{
        ut_print_namel(f, trx, table_id, name, strlen(name));
}

Here is the call graph for this function:

Here is the caller graph for this function:

void ut_print_namel	(	FILE *	f,
		struct trx_struct *	trx,
		ibool	table_id,
		const char *	name,
		ulint	namelen
	)

Definition at line 415 of file ut0ut.c.

References innobase_print_identifier(), strchr(), TRUE, and ut_ad.

Referenced by dict_print(), dict_print_info_on_foreign_key_in_create_format(), and ut_print_name().

                                     : output stream */
        trx_t*          trx,    /* in: transaction (NULL=no quotes) */
        ibool           table_id,/* in: TRUE=print a table name,
                                FALSE=print other identifier */
        const char*     name,   /* in: name to print */
        ulint           namelen)/* in: length of name */
{
#ifdef UNIV_HOTBACKUP
        fwrite(name, 1, namelen, f);
#else
        char*   slash = strchr(name, '/');

        if (UNIV_LIKELY_NULL(slash)) {
                /* Print the database name and table name separately. */
                ut_ad(table_id);

                innobase_print_identifier(f, trx, TRUE, name, slash - name);
                putc('.', f);
                innobase_print_identifier(f, trx, TRUE, slash + 1,
                                namelen - (slash - name) - 1);
        } else {
                innobase_print_identifier(f, trx, table_id, name, namelen);
        }
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void ut_print_timestamp

(

FILE *

file

)

Definition at line 118 of file ut0ut.c.

References localtime_r().

Referenced by btr_search_drop_page_hash_index(), btr_search_validate(), buf_flush_buffered_writes(), buf_flush_ready_for_replace(), buf_LRU_get_free_block(), buf_page_io_complete(), buf_page_is_corrupted(), buf_page_print(), buf_read_page(), buf_read_page_low(), cmp_whole_field(), dict_foreign_error_report_low(), dict_foreign_eval_sql(), dict_foreign_parse_drop_constraints(), dict_load_table(), dict_truncate_index_tree(), dict_update_statistics_low(), fil_assign_new_space_id(), fil_create_new_single_table_tablespace(), fil_delete_tablespace(), fil_io(), fil_mutex_enter_and_prepare_for_io(), fil_node_create(), fil_node_open_file(), fil_node_prepare_for_io(), fil_open_single_table_tablespace(), fil_rename_tablespace(), fil_reset_too_high_lsns(), fil_space_create(), fil_space_for_table_exists_in_mem(), fil_space_free(), ha_validate(), ibuf_insert_to_index_page(), ibuf_merge_or_delete_for_page(), innobase_shutdown_for_mysql(), innobase_start_or_create_for_mysql(), lock_check_trx_id_sanity(), lock_deadlock_recursive(), lock_rec_enqueue_waiting(), lock_rec_unlock(), lock_table_enqueue_waiting(), log_close(), logs_empty_and_mark_files_at_shutdown(), mem_pool_fill_free_list(), open_or_create_data_files(), open_or_create_log_file(), os_awe_map_physical_mem_to_window(), os_fast_mutex_free(), os_file_check_page_trailers(), os_file_create(), os_file_create_tmpfile(), os_file_flush(), os_file_get_last_error(), os_file_handle_error(), os_file_handle_error_no_exit(), os_file_write(), page_copy_rec_list_end_no_locks(), recv_apply_hashed_log_recs(), recv_recovery_from_checkpoint_start(), row_check_table_for_mysql(), row_create_index_for_mysql(), row_create_table_for_mysql(), row_discard_tablespace_for_mysql(), row_drop_database_for_mysql(), row_drop_table_for_mysql(), row_drop_tables_for_mysql_in_background(), row_import_tablespace_for_mysql(), row_ins_foreign_report_add_err(), row_ins_foreign_report_err(), row_insert_for_mysql(), row_rename_table_for_mysql(), row_search_for_mysql(), row_sel_convert_mysql_key_to_innobase(), row_sel_get_clust_rec_for_mysql(), row_truncate_table_for_mysql(), row_update_for_mysql(), srv_conc_enter_innodb(), srv_error_monitor_thread(), srv_lock_timeout_and_monitor_thread(), srv_printf_innodb_monitor(), srv_table_reserve_slot_for_mysql(), trx_free(), trx_purge_rseg_get_next_history_log(), trx_recover_for_mysql(), trx_rollback_or_clean_all_without_sess(), trx_rollback_to_savepoint_for_mysql(), trx_undo_seg_create(), ut_dbg_assertion_failed(), ut_malloc_low(), and ut_test_malloc().

                          : file where to print */
{
#ifdef __WIN__
        SYSTEMTIME cal_tm;

        GetLocalTime(&cal_tm);

        fprintf(file,"%02d%02d%02d %2d:%02d:%02d",
          (int)cal_tm.wYear % 100,
          (int)cal_tm.wMonth,
          (int)cal_tm.wDay,
          (int)cal_tm.wHour,
          (int)cal_tm.wMinute,
          (int)cal_tm.wSecond);
#else
        struct tm  cal_tm;
        struct tm* cal_tm_ptr;
        time_t     tm;

        time(&tm);

#ifdef HAVE_LOCALTIME_R
        localtime_r(&tm, &cal_tm);
        cal_tm_ptr = &cal_tm;
#else
        cal_tm_ptr = localtime(&tm);
#endif
        fprintf(file,"%02d%02d%02d %2d:%02d:%02d",
          cal_tm_ptr->tm_year % 100,
          cal_tm_ptr->tm_mon + 1,
          cal_tm_ptr->tm_mday,
          cal_tm_ptr->tm_hour,
          cal_tm_ptr->tm_min,
          cal_tm_ptr->tm_sec);
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void ut_sprintf_timestamp

(

char *

buf

)

Definition at line 161 of file ut0ut.c.

References localtime_r().

Referenced by log_reset_first_header_and_checkpoint().

                          : buffer where to sprintf */
{
#ifdef __WIN__
        SYSTEMTIME cal_tm;

        GetLocalTime(&cal_tm);

        sprintf(buf, "%02d%02d%02d %2d:%02d:%02d",
          (int)cal_tm.wYear % 100,
          (int)cal_tm.wMonth,
          (int)cal_tm.wDay,
          (int)cal_tm.wHour,
          (int)cal_tm.wMinute,
          (int)cal_tm.wSecond);
#else
        struct tm  cal_tm;
        struct tm* cal_tm_ptr;
        time_t     tm;

        time(&tm);

#ifdef HAVE_LOCALTIME_R
        localtime_r(&tm, &cal_tm);
        cal_tm_ptr = &cal_tm;
#else
        cal_tm_ptr = localtime(&tm);
#endif
        sprintf(buf, "%02d%02d%02d %2d:%02d:%02d",
          cal_tm_ptr->tm_year % 100,
          cal_tm_ptr->tm_mon + 1,
          cal_tm_ptr->tm_mday,
          cal_tm_ptr->tm_hour,
          cal_tm_ptr->tm_min,
          cal_tm_ptr->tm_sec);
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void ut_sprintf_timestamp_without_extra_chars

(

char *

buf

)

Definition at line 205 of file ut0ut.c.

References localtime_r().

                          : buffer where to sprintf */
{
#ifdef __WIN__
        SYSTEMTIME cal_tm;

        GetLocalTime(&cal_tm);

        sprintf(buf, "%02d%02d%02d_%2d_%02d_%02d",
          (int)cal_tm.wYear % 100,
          (int)cal_tm.wMonth,
          (int)cal_tm.wDay,
          (int)cal_tm.wHour,
          (int)cal_tm.wMinute,
          (int)cal_tm.wSecond);
#else
        struct tm  cal_tm;
        struct tm* cal_tm_ptr;
        time_t     tm;

        time(&tm);

#ifdef HAVE_LOCALTIME_R
        localtime_r(&tm, &cal_tm);
        cal_tm_ptr = &cal_tm;
#else
        cal_tm_ptr = localtime(&tm);
#endif
        sprintf(buf, "%02d%02d%02d_%2d_%02d_%02d",
          cal_tm_ptr->tm_year % 100,
          cal_tm_ptr->tm_mon + 1,
          cal_tm_ptr->tm_mday,
          cal_tm_ptr->tm_hour,
          cal_tm_ptr->tm_min,
          cal_tm_ptr->tm_sec);
#endif
}

Here is the call graph for this function:

ib_time_t ut_time

(

void

)

Definition at line 73 of file ut0ut.c.

References NULL.

Referenced by eval_predefined(), srv_lock_timeout_and_monitor_thread(), srv_suspend_mysql_thread(), and srv_table_reserve_slot_for_mysql().

{
        return(time(NULL));
}

Here is the caller graph for this function:

UNIV_INLINE int ut_ulint_cmp	(	ulint	a,
		ulint	b
	)

Referenced by buf_read_ahead_linear(), and ut_ulint_sort().

Here is the caller graph for this function:

void ut_ulint_sort	(	ulint *	arr,
		ulint *	aux_arr,
		ulint	low,
		ulint	high
	)

Definition at line 341 of file ut0ut.c.

References UT_SORT_FUNCTION_BODY, ut_ulint_cmp(), and ut_ulint_sort().

Referenced by ut_ulint_sort().

{
        UT_SORT_FUNCTION_BODY(ut_ulint_sort, arr, aux_arr, low, high,
                                                                ut_ulint_cmp);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void ut_usectime	(	ulint *	sec,
		ulint *	ms
	)

Definition at line 83 of file ut0ut.c.

References NULL.

Referenced by mutex_spin_wait(), and srv_suspend_mysql_thread().

                              : seconds since the Epoch */
        ulint*  ms)     /* out: microseconds since the Epoch+*sec */
{
#ifdef __WIN__
        SYSTEMTIME st;
        GetLocalTime(&st);
        *sec = (ulint) st.wSecond;
        *ms  = (ulint) st.wMilliseconds;
#else
        struct timeval  tv;
        gettimeofday(&tv,NULL);
        *sec = (ulint) tv.tv_sec;
        *ms  = (ulint) tv.tv_usec;
#endif
}

Here is the caller graph for this function:

---

• Products
• MySQL Enterprise
• MySQL Cluster
• MySQL Embedded (OEM/ISV)
• MySQL Data Warehouse
• MySQL Backup & Recovery
• MySQL Workbench
• MySQL Connectors
• Online Shop

• Downloads
• MySQL Community Server
• MySQL Enterprise
• MySQL Proxy
• MySQL Cluster
• MySQL Workbench
• GUI Tools
• Connectors
• Archives
• Snapshots
• Mirrors

• Developer Zone
• Documentation
• Librarian
• Developer Articles
• Forums
• Bugs
• Forge
• Planet MySQL
• Labs
• MySQL Meetups
• Guilds
• Lists

• About
• About MySQL
• Contact Us
• Legal
• Privacy Policy
• Job Opportunities
• Site Map

© 1995-2008 MySQL AB, 2008- Sun Microsystems, Inc.