mirror of
				https://source.denx.de/u-boot/u-boot.git
				synced 2025-11-04 10:21:25 +01:00 
			
		
		
		
	On boards without console recording these function are currently missing. It is more convenient for them to be present but to return dummy values. That way if we know that a test needs recording, we can check if it is available, and skip the test if not, while avoiding #ifdefs. Update the header file according and adjust console_record_reset_enable() to return an error if recording is not available. Signed-off-by: Simon Glass <sjg@chromium.org>
		
			
				
	
	
		
			134 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			134 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* SPDX-License-Identifier: GPL-2.0+ */
 | 
						|
/*
 | 
						|
 * (C) Copyright 2000-2009
 | 
						|
 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef __CONSOLE_H
 | 
						|
#define __CONSOLE_H
 | 
						|
 | 
						|
#include <stdbool.h>
 | 
						|
#include <linux/errno.h>
 | 
						|
 | 
						|
extern char console_buffer[];
 | 
						|
 | 
						|
/* common/console.c */
 | 
						|
int console_init_f(void);	/* Before relocation; uses the serial  stuff */
 | 
						|
int console_init_r(void);	/* After  relocation; uses the console stuff */
 | 
						|
int console_assign(int file, const char *devname);	/* Assign the console */
 | 
						|
int ctrlc(void);
 | 
						|
int had_ctrlc(void);	/* have we had a Control-C since last clear? */
 | 
						|
void clear_ctrlc(void);	/* clear the Control-C condition */
 | 
						|
int disable_ctrlc(int);	/* 1 to disable, 0 to enable Control-C detect */
 | 
						|
int confirm_yesno(void);        /*  1 if input is "y", "Y", "yes" or "YES" */
 | 
						|
 | 
						|
#ifdef CONFIG_CONSOLE_RECORD
 | 
						|
/**
 | 
						|
 * console_record_init() - set up the console recording buffers
 | 
						|
 *
 | 
						|
 * This should be called as soon as malloc() is available so that the maximum
 | 
						|
 * amount of console output can be recorded.
 | 
						|
 *
 | 
						|
 * @return 0 if OK, -ENOMEM if out of memory
 | 
						|
 */
 | 
						|
int console_record_init(void);
 | 
						|
 | 
						|
/**
 | 
						|
 * console_record_reset() - reset the console recording buffers
 | 
						|
 *
 | 
						|
 * Removes any data in the buffers
 | 
						|
 */
 | 
						|
void console_record_reset(void);
 | 
						|
 | 
						|
/**
 | 
						|
 * console_record_reset_enable() - reset and enable the console buffers
 | 
						|
 *
 | 
						|
 * This should be called to enable the console buffer.
 | 
						|
 *
 | 
						|
 * @return 0 (always)
 | 
						|
 */
 | 
						|
int console_record_reset_enable(void);
 | 
						|
 | 
						|
/**
 | 
						|
 * console_record_readline() - Read a line from the console output
 | 
						|
 *
 | 
						|
 * This reads the next available line from the console output previously
 | 
						|
 * recorded.
 | 
						|
 *
 | 
						|
 * @str: Place to put string
 | 
						|
 * @maxlen: Maximum length of @str including nul terminator
 | 
						|
 * @return length of string returned
 | 
						|
 */
 | 
						|
int console_record_readline(char *str, int maxlen);
 | 
						|
 | 
						|
/**
 | 
						|
 * console_record_avail() - Get the number of available bytes in console output
 | 
						|
 *
 | 
						|
 * @return available bytes (0 if empty)
 | 
						|
 */
 | 
						|
int console_record_avail(void);
 | 
						|
#else
 | 
						|
static inline int console_record_init(void)
 | 
						|
{
 | 
						|
	/* Always succeed, since it is not enabled */
 | 
						|
 | 
						|
	return 0;
 | 
						|
}
 | 
						|
 | 
						|
static inline void console_record_reset(void)
 | 
						|
{
 | 
						|
	/* Nothing to do here */
 | 
						|
}
 | 
						|
 | 
						|
static inline int console_record_reset_enable(void)
 | 
						|
{
 | 
						|
	/* Cannot enable it as it is not supported */
 | 
						|
	return -ENOSYS;
 | 
						|
}
 | 
						|
 | 
						|
static inline int console_record_readline(char *str, int maxlen)
 | 
						|
{
 | 
						|
	/* Nothing to read */
 | 
						|
	return 0;
 | 
						|
}
 | 
						|
 | 
						|
static inline int console_record_avail(void)
 | 
						|
{
 | 
						|
	/* There is never anything available */
 | 
						|
	return 0;
 | 
						|
}
 | 
						|
 | 
						|
#endif /* !CONFIG_CONSOLE_RECORD */
 | 
						|
 | 
						|
/**
 | 
						|
 * console_announce_r() - print a U-Boot console on non-serial consoles
 | 
						|
 *
 | 
						|
 * When U-Boot starts up with a display it generally does not announce itself
 | 
						|
 * on the display. The banner is instead emitted on the UART before relocation.
 | 
						|
 * This function prints a banner on devices which (we assume) did not receive
 | 
						|
 * it before relocation.
 | 
						|
 *
 | 
						|
 * @return 0 (meaning no errors)
 | 
						|
 */
 | 
						|
int console_announce_r(void);
 | 
						|
 | 
						|
/**
 | 
						|
 * console_puts_select_stderr() - Output a string to selected console devices
 | 
						|
 *
 | 
						|
 * This writes to stderr only. It is useful for outputting errors
 | 
						|
 *
 | 
						|
 * @serial_only: true to output only to serial, false to output to everything
 | 
						|
 *	else
 | 
						|
 * @s: String to output
 | 
						|
 */
 | 
						|
void console_puts_select_stderr(bool serial_only, const char *s);
 | 
						|
 | 
						|
/*
 | 
						|
 * CONSOLE multiplexing.
 | 
						|
 */
 | 
						|
#ifdef CONFIG_CONSOLE_MUX
 | 
						|
#include <iomux.h>
 | 
						|
#endif
 | 
						|
 | 
						|
#endif
 |