Merge tag 's390-5.9-1' of git://git.kernel.org/pub/scm/linux/kernel/git/s390/linux

The content of the directories are files which represent different views

to the debug log. Each component can decide which views should be

used through registering them with the function :c:func:`debug_register_view()`.

Predefined views for hex/ascii, sprintf and raw binary data are provided.

Predefined views for hex/ascii and sprintf data are provided.

It is also possible to define other views. The content of

a view can be inspected simply by reading the corresponding debugfs file.

  extern struct debug_view debug_hex_ascii_view;

  extern struct debug_view debug_raw_view;

  extern struct debug_view debug_sprintf_view;

Examples

.. code-block:: c

  /*

   * hex_ascii- + raw-view Example

   * hex_ascii-view Example

   */

  #include <linux/init.h>

      debug_info = debug_register("test", 1, 4, 4 );

      debug_register_view(debug_info, &debug_hex_ascii_view);

      debug_register_view(debug_info, &debug_raw_view);

      debug_text_event(debug_info, 4 , "one ");

      debug_int_exception(debug_info, 4, 4711);

Example::

  > ls /sys/kernel/debug/s390dbf/dasd

  flush  hex_ascii  level pages raw

  flush  hex_ascii  level pages

  > cat /sys/kernel/debug/s390dbf/dasd/hex_ascii | sort -k2,2 -s

  00 00974733272:680099 2 - 02 0006ad7e  07 ea 4a 90 | ....

  00 00974733272:682210 2 - 02 0006ade6  46 52 45 45 | FREE

Predefined Views

----------------

There are three predefined views: hex_ascii, raw and sprintf.

There are two predefined views: hex_ascii and sprintf.

The hex_ascii view shows the data field in hex and ascii representation

(e.g. ``45 43 4b 44 | ECKD``).

The raw view returns a bytestream as the debug areas are stored in memory.

The sprintf view formats the debug entries in the same way as the sprintf

function would do. The sprintf event/exception functions write to the

- Return Address to caller

- data field

The format of the raw view is:

- Header as described in debug.h

- datafield

A typical line of the hex_ascii view will look like the following (first line

is only for explanation and will not be displayed when 'cating' the view)::

	select ARCH_INLINE_WRITE_UNLOCK_BH

	select ARCH_INLINE_WRITE_UNLOCK_IRQ

	select ARCH_INLINE_WRITE_UNLOCK_IRQRESTORE

	select ARCH_KEEP_MEMBLOCK

	select ARCH_STACKWALK

	select ARCH_SUPPORTS_ATOMIC_RMW

	select ARCH_SUPPORTS_NUMA_BALANCING

	select HAVE_ARCH_JUMP_LABEL_RELATIVE

	select HAVE_ARCH_KASAN

	select HAVE_ARCH_KASAN_VMALLOC

	select CLOCKSOURCE_VALIDATE_LAST_CYCLE

	select CPU_NO_EFFICIENT_FFS if !HAVE_MARCH_Z9_109_FEATURES

	select HAVE_ARCH_SECCOMP_FILTER

	select HAVE_ARCH_SOFT_DIRTY

	select HAVE_EFFICIENT_UNALIGNED_ACCESS

	select HAVE_FENTRY

	select HAVE_FTRACE_MCOUNT_RECORD

	select HAVE_FUNCTION_ERROR_INJECTION

	select HAVE_FUNCTION_GRAPH_TRACER

	select HAVE_FUNCTION_TRACER

	select HAVE_FUTEX_CMPXCHG if FUTEX

config ARCH_ENABLE_SPLIT_PMD_PTLOCK

	def_bool y

config FORCE_MAX_ZONEORDER

	int

	default "9"

config MAX_PHYSMEM_BITS

	int "Maximum size of supported physical memory in bits (42-53)"

	range 42 53

	os_data->nr_cpus = j;

	new_size = sizeof(struct appldata_os_data) +

		   (os_data->nr_cpus * sizeof(struct appldata_os_per_cpu));

	new_size = struct_size(os_data, os_cpu, os_data->nr_cpus);

	if (ops.size != new_size) {

		if (ops.active) {

			rc = appldata_diag(APPLDATA_RECORD_OS_ID,

{

	int rc, max_size;

	max_size = sizeof(struct appldata_os_data) +

		   (num_possible_cpus() * sizeof(struct appldata_os_per_cpu));

	max_size = struct_size(appldata_os_data, os_cpu, num_possible_cpus());

	if (max_size > APPLDATA_MAX_REC_SIZE) {

		pr_err("Maximum OS record size %i exceeds the maximum "

		       "record size %i\n", max_size, APPLDATA_MAX_REC_SIZE);

/* SPDX-License-Identifier: GPL-2.0 */

#ifndef _ASM_S390_ASM_CONST_H

#define _ASM_S390_ASM_CONST_H

#ifdef __ASSEMBLY__

#  define stringify_in_c(...)	__VA_ARGS__

#else

/* This version of stringify will deal with commas... */

#  define __stringify_in_c(...)	#__VA_ARGS__

#  define stringify_in_c(...)	__stringify_in_c(__VA_ARGS__) " "

#endif

#endif /* _ASM_S390_ASM_CONST_H */

#include <linux/kernel.h>

#include <linux/time.h>

#include <linux/refcount.h>

#include <uapi/asm/debug.h>

#include <linux/fs.h>

#define DEBUG_MAX_LEVEL		   6  /* debug levels range from 0 to 6 */

#define DEBUG_OFF_LEVEL		   -1 /* level where debug is switched off */

#define DEBUG_DATA(entry) (char *)(entry + 1) /* data is stored behind */

					      /* the entry information */

#define __DEBUG_FEATURE_VERSION	   2  /* version of debug feature */

struct __debug_entry {

	union {

		struct {

			unsigned long clock	: 52;

			unsigned long exception	:  1;

			unsigned long level	:  3;

			unsigned long cpuid	:  8;

		} fields;

		unsigned long stck;

	} id;

	void *caller;

} __packed;

typedef struct __debug_entry debug_entry_t;

struct debug_view;

};

extern struct debug_view debug_hex_ascii_view;

extern struct debug_view debug_raw_view;

extern struct debug_view debug_sprintf_view;

/* do NOT use the _common functions */