XZ Utils
5.2.2
|
Printing messages. More...
Functions | |
void | message_init (void) |
Initializes the message functions. More... | |
void | message_verbosity_increase (void) |
Increase verbosity level by one step unless it was at maximum. More... | |
void | message_verbosity_decrease (void) |
Decrease verbosity level by one step unless it was at minimum. More... | |
enum message_verbosity | message_verbosity_get (void) |
Get the current verbosity level. More... | |
void | message_set_files (unsigned int files) |
Set the total number of files to be processed. More... | |
static void | print_filename (void) |
void | message_filename (const char *src_name) |
Set the name of the current file and possibly print it too. More... | |
void | message_progress_start (lzma_stream *strm, uint64_t in_size) |
Start progress info handling. More... | |
static const char * | progress_percentage (uint64_t in_pos) |
Make the string indicating completion percentage. More... | |
static const char * | progress_sizes (uint64_t compressed_pos, uint64_t uncompressed_pos, bool final) |
static const char * | progress_speed (uint64_t uncompressed_pos, uint64_t elapsed) |
Make the string containing the processing speed of uncompressed data. More... | |
static const char * | progress_time (uint64_t mseconds) |
static const char * | progress_remaining (uint64_t in_pos, uint64_t elapsed) |
static void | progress_pos (uint64_t *in_pos, uint64_t *compressed_pos, uint64_t *uncompressed_pos) |
Get how much uncompressed and compressed data has been processed. More... | |
void | message_progress_update (void) |
static void | progress_flush (bool finished) |
void | message_progress_end (bool success) |
Finishes the progress message if we were in verbose mode. More... | |
static void | vmessage (enum message_verbosity v, const char *fmt, va_list ap) |
void | message (enum message_verbosity v, const char *fmt,...) |
void | message_warning (const char *fmt,...) |
void | message_error (const char *fmt,...) |
void | message_fatal (const char *fmt,...) |
void | message_bug (void) |
void | message_signal_handler (void) |
const char * | message_strm (lzma_ret code) |
Convert lzma_ret to a string. More... | |
void | message_mem_needed (enum message_verbosity v, uint64_t memusage) |
Display how much memory was needed and how much the limit was. More... | |
static const char * | uint32_to_optstr (uint32_t num) |
Convert uint32_t to a nice string for –lzma[12]=dict=SIZE. More... | |
void | message_filters_to_str (char buf[FILTERS_STR_SIZE], const lzma_filter *filters, bool all_known) |
Get the filter chain as a string. More... | |
void | message_filters_show (enum message_verbosity v, const lzma_filter *filters) |
Print the filter chain. More... | |
void | message_try_help (void) |
Print a message that user should try –help. More... | |
void | message_version (void) |
Prints the version number to stdout and exits with exit status SUCCESS. More... | |
void | message_help (bool long_help) |
Print the help message. More... | |
Variables | |
static unsigned int | files_pos = 0 |
Number of the current file. More... | |
static unsigned int | files_total |
Total number of input files; zero if unknown. More... | |
static enum message_verbosity | verbosity = V_WARNING |
Verbosity level. More... | |
static const char * | filename |
Filename which we will print with the verbose messages. More... | |
static bool | first_filename_printed = false |
static bool | current_filename_printed = false |
static bool | progress_automatic |
static bool | progress_started = false |
static bool | progress_active = false |
static lzma_stream * | progress_strm |
Pointer to lzma_stream used to do the encoding or decoding. More... | |
static uint64_t | expected_in_size |
static bool | progress_needs_updating = false |
static uint64_t | progress_next_update |
Elapsed time when the next progress message update should be done. More... | |
Printing messages.
void message_init | ( | void | ) |
Initializes the message functions.
If an error occurs, this function doesn't return.
References message_progress_sigs, message_signal_handler(), and progress_automatic.
Referenced by set_exit_no_warn().
void message_verbosity_increase | ( | void | ) |
Increase verbosity level by one step unless it was at maximum.
References V_DEBUG, and verbosity.
Referenced by parse_memlimit().
void message_verbosity_decrease | ( | void | ) |
Decrease verbosity level by one step unless it was at minimum.
References V_SILENT, and verbosity.
Referenced by parse_memlimit().
enum message_verbosity message_verbosity_get | ( | void | ) |
Get the current verbosity level.
References verbosity.
Referenced by get_check_names(), hardware_memlimit_show(), list_file(), list_totals(), and set_exit_no_warn().
void message_set_files | ( | unsigned int | files | ) |
Set the total number of files to be processed.
Standard input is counted as a file here. This is used when printing the filename via message_filename().
References files_total.
Referenced by set_exit_no_warn().
|
static |
Prints the name of the current file if it hasn't been printed already, except if we are processing exactly one stream from stdin to stdout. I think it looks nicer to not print "(stdin)" when –verbose is used in a pipe and no other files are processed.
References current_filename_printed, filename, files_pos, files_total, first_filename_printed, opt_mode, signals_block(), and signals_unblock().
Referenced by message_filename(), and message_progress_update().
void message_filename | ( | const char * | src_name | ) |
Set the name of the current file and possibly print it too.
The name is printed immediately if –list was used or if –verbose was used and stderr is a terminal. Even when the filename isn't printed, it is stored so that it can be printed later if needed for progress messages.
References current_filename_printed, filename, files_pos, opt_mode, print_filename(), progress_automatic, V_VERBOSE, and verbosity.
Referenced by coder_run(), and list_file().
void message_progress_start | ( | lzma_stream * | strm, |
uint64_t | in_size | ||
) |
Start progress info handling.
message_filename() must be called before this function to set the filename.
This must be paired with a call to message_progress_end() before the given *strm becomes invalid.
strm | Pointer to lzma_stream used for the coding. |
in_size | Size of the input file, or zero if unknown. |
References expected_in_size, progress_automatic, progress_needs_updating, progress_next_update, progress_started, strm, V_VERBOSE, and verbosity.
Referenced by coder_run().
|
static |
Make the string indicating completion percentage.
References expected_in_size.
Referenced by message_progress_update().
|
static |
Make the string containing the amount of input processed, amount of output produced, and the compression ratio.
References my_snprintf(), and uint64_to_nicestr().
Referenced by message_progress_update().
|
static |
Make the string containing the processing speed of uncompressed data.
Referenced by message_progress_update().
|
static |
Make a string indicating elapsed time. The format is either M:SS or H:MM:SS depending on if the time is an hour or more.
Referenced by message_progress_update().
|
static |
Return a string containing estimated remaining time when reasonably possible.
References expected_in_size.
Referenced by message_progress_update().
|
static |
Get how much uncompressed and compressed data has been processed.
References lzma_get_progress(), opt_mode, and lzma_stream::total_out.
Referenced by message_progress_update().
void message_progress_update | ( | void | ) |
Update the progress info if in verbose mode and enough time has passed since the previous update. This can be called only when message_progress_start() has already been used.
References current_filename_printed, filename, mytime_get_elapsed(), print_filename(), progress_active, progress_automatic, progress_needs_updating, progress_next_update, progress_percentage(), progress_pos(), progress_remaining(), progress_sizes(), progress_speed(), progress_started, progress_time(), signals_block(), signals_unblock(), V_VERBOSE, and verbosity.
Referenced by coder_normal(), and coder_passthru().
void message_progress_end | ( | bool | finished | ) |
Finishes the progress message if we were in verbose mode.
finished | True if the whole stream was successfully coded and output written to the output stream. |
References message(), message_error(), message_fatal(), message_warning(), progress_started, set_exit_status(), signals_block(), signals_unblock(), V_ERROR, V_WARNING, and verbosity.
Referenced by coder_run().
void message_bug | ( | void | ) |
Print an error message that an internal error occurred and exit with EXIT_ERROR.
References message_fatal().
Referenced by coder_add_filter(), io_read(), options_lzma(), parse_block_header(), and parse_indexes().
void message_signal_handler | ( | void | ) |
Print a message that establishing signal handlers failed, and exit with exit status ERROR.
References message_fatal().
Referenced by message_init(), signals_exit(), and signals_init().
const char* message_strm | ( | lzma_ret | code | ) |
Convert lzma_ret to a string.
References LZMA_BUF_ERROR, LZMA_DATA_ERROR, LZMA_FORMAT_ERROR, LZMA_GET_CHECK, LZMA_MEM_ERROR, LZMA_NO_CHECK, LZMA_OK, LZMA_OPTIONS_ERROR, LZMA_PROG_ERROR, LZMA_STREAM_END, and LZMA_UNSUPPORTED_CHECK.
Referenced by coder_init(), coder_normal(), parse_block_header(), and parse_indexes().
void message_mem_needed | ( | enum message_verbosity | v, |
uint64_t | memusage | ||
) |
Display how much memory was needed and how much the limit was.
References hardware_memlimit_get(), message(), opt_mode, round_up_to_mib(), uint64_to_str(), and verbosity.
Referenced by coder_add_filter(), coder_init(), coder_normal(), and parse_indexes().
|
static |
Convert uint32_t to a nice string for –lzma[12]=dict=SIZE.
The idea is to use KiB or MiB suffix when possible.
Referenced by message_filters_to_str().
void message_filters_to_str | ( | char | buf[FILTERS_STR_SIZE], |
const lzma_filter * | filters, | ||
bool | all_known | ||
) |
Get the filter chain as a string.
buf | Pointer to caller allocated buffer to hold the filter chain string |
filters | Pointer to the filter chain |
all_known | If true, all filter options are printed. If false, only the options that get stored into .xz headers are printed. |
References lzma_options_lzma::depth, lzma_options_lzma::dict_size, lzma_options_delta::dist, FILTERS_STR_SIZE, lzma_filter::id, lzma_options_lzma::lc, lzma_options_lzma::lp, LZMA_FILTER_ARM, LZMA_FILTER_ARMTHUMB, LZMA_FILTER_DELTA, LZMA_FILTER_IA64, LZMA_FILTER_LZMA1, LZMA_FILTER_LZMA2, LZMA_FILTER_POWERPC, LZMA_FILTER_SPARC, LZMA_FILTER_X86, LZMA_MF_BT2, LZMA_MF_BT3, LZMA_MF_BT4, LZMA_MF_HC3, LZMA_MF_HC4, LZMA_MODE_FAST, LZMA_MODE_NORMAL, LZMA_VLI_UNKNOWN, lzma_options_lzma::mf, lzma_options_lzma::mode, my_snprintf(), lzma_options_lzma::nice_len, lzma_filter::options, lzma_options_lzma::pb, lzma_options_bcj::start_offset, and uint32_to_optstr().
Referenced by message_filters_show(), and parse_block_header().
void message_filters_show | ( | enum message_verbosity | v, |
const lzma_filter * | filters | ||
) |
Print the filter chain.
References FILTERS_STR_SIZE, message_filters_to_str(), and verbosity.
Referenced by coder_add_filter().
void message_try_help | ( | void | ) |
Print a message that user should try –help.
References message(), and V_WARNING.
Referenced by parse_memlimit(), and set_exit_no_warn().
void message_version | ( | void | ) |
Prints the version number to stdout and exits with exit status SUCCESS.
References LZMA_VERSION, lzma_version_number(), LZMA_VERSION_STRING, lzma_version_string(), V_SILENT, and verbosity.
Referenced by parse_memlimit().
void message_help | ( | bool | long_help | ) |
|
static |
Number of the current file.
Referenced by message_filename(), and print_filename().
|
static |
Total number of input files; zero if unknown.
Referenced by message_set_files(), and print_filename().
|
static |
|
static |
Filename which we will print with the verbose messages.
Referenced by message_filename(), message_progress_update(), parse_options(), print_filename(), and set_exit_no_warn().
|
static |
True once the a filename has been printed to stderr as part of progress message. If automatic progress updating isn't enabled, this becomes true after the first progress message has been printed due to user sending SIGINFO, SIGUSR1, or SIGALRM. Once this variable is true, we will print an empty line before the next filename to make the output more readable.
Referenced by print_filename().
|
static |
This is set to true when we have printed the current filename to stderr as part of a progress message. This variable is useful only if not updating progress automatically: if user sends many SIGINFO, SIGUSR1, or SIGALRM signals, we won't print the name of the same file multiple times.
Referenced by message_filename(), message_progress_update(), and print_filename().
|
static |
True if we should print progress indicator and update it automatically if also verbose >= V_VERBOSE.
Referenced by message_filename(), message_init(), message_progress_start(), and message_progress_update().
|
static |
True if message_progress_start() has been called but message_progress_end() hasn't been called yet.
Referenced by message_progress_end(), message_progress_start(), and message_progress_update().
|
static |
This is true when a progress message was printed and the cursor is still on the same line with the progress message. In that case, a newline has to be printed before any error messages.
Referenced by message_progress_update().
|
static |
Pointer to lzma_stream used to do the encoding or decoding.
|
static |
Expected size of the input stream is needed to show completion percentage and estimate remaining time.
Referenced by message_progress_start(), progress_percentage(), and progress_remaining().
|
static |
This is true when progress message printing is wanted. Using the same variable name as above to avoid some ifdefs.
Referenced by message_progress_start(), and message_progress_update().
|
static |
Elapsed time when the next progress message update should be done.
Referenced by message_progress_start(), and message_progress_update().