mirror of
https://gitlab.rtems.org/rtems/rtos/rtems.git
synced 2026-10-06 10:59:48 +08:00
Sebastian Huber
7caa18eaec
The capture engine, the monitor and the stdio redirector had no group on any file. The flattened device tree implementation sat in rtems_fdt, the group of its API. The string conversion, the BSP command line, the dump buffer and the stack checker sources sat in the API group of the interface they implement. Twenty-four files wrote the group title after the group name, so Doxygen looked for one group per title word. Give each component the group of its implementation. The stdio redirector works on file descriptors, so it joins LibIO. Drop the group title from every @ingroup line. Updates #5717. Assisted-by: Claude:claude-opus-5 claude-code Signed-off-by: Sebastian Huber <sebastian.huber@embedded-brains.de>
190 lines
4.0 KiB
C
190 lines
4.0 KiB
C
/* SPDX-License-Identifier: GPL-2.0-with-RTEMS-exception */
|
|
|
|
/**
|
|
* @file
|
|
*
|
|
* @ingroup libmisc_devnull
|
|
*
|
|
* @brief Null Device Driver Init Routine
|
|
*
|
|
* Derived from rtems' stub driver.
|
|
*/
|
|
|
|
/*
|
|
* Author: Ralf Corsepius (corsepiu@faw.uni-ulm.de)
|
|
*
|
|
* COPYRIGHT (c) 1989-2000.
|
|
* On-Line Applications Research Corporation (OAR).
|
|
*
|
|
* The license and distribution terms for this file may be
|
|
* found in the file LICENSE in this distribution or at
|
|
* http://www.rtems.org/license/LICENSE.
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include <rtems.h>
|
|
#include <rtems/devnull.h>
|
|
#include <rtems/libio.h>
|
|
|
|
/* null_initialize
|
|
*
|
|
* This routine is the null device driver init routine.
|
|
*
|
|
* Input parameters:
|
|
* major - device major number
|
|
* minor - device minor number
|
|
* pargp - pointer to parameter block
|
|
*
|
|
* Output parameters:
|
|
* rval - NULL_SUCCESSFUL
|
|
*/
|
|
|
|
uint32_t NULL_major;
|
|
static char initialized;
|
|
|
|
rtems_device_driver null_initialize(
|
|
rtems_device_major_number major,
|
|
rtems_device_minor_number minor RTEMS_UNUSED,
|
|
void *pargp RTEMS_UNUSED
|
|
)
|
|
{
|
|
rtems_device_driver status;
|
|
|
|
if ( !initialized ) {
|
|
initialized = 1;
|
|
|
|
status = rtems_io_register_name(
|
|
"/dev/null",
|
|
major,
|
|
(rtems_device_minor_number) 0
|
|
);
|
|
|
|
if ( status != RTEMS_SUCCESSFUL ) {
|
|
rtems_fatal_error_occurred( status );
|
|
}
|
|
|
|
NULL_major = major;
|
|
}
|
|
|
|
return RTEMS_SUCCESSFUL;
|
|
}
|
|
|
|
/* null_open
|
|
*
|
|
* This routine is the null device driver open routine.
|
|
*
|
|
* Input parameters:
|
|
* major - device major number
|
|
* minor - device minor number
|
|
* pargb - pointer to open parameter block
|
|
*
|
|
* Output parameters:
|
|
* rval - NULL_SUCCESSFUL
|
|
*/
|
|
|
|
rtems_device_driver null_open(
|
|
rtems_device_major_number major RTEMS_UNUSED,
|
|
rtems_device_minor_number minor RTEMS_UNUSED,
|
|
void *pargp RTEMS_UNUSED
|
|
)
|
|
{
|
|
return NULL_SUCCESSFUL;
|
|
}
|
|
|
|
/* null_close
|
|
*
|
|
* This routine is the null device driver close routine.
|
|
*
|
|
* Input parameters:
|
|
* major - device major number
|
|
* minor - device minor number
|
|
* pargb - pointer to close parameter block
|
|
*
|
|
* Output parameters:
|
|
* rval - NULL_SUCCESSFUL
|
|
*/
|
|
|
|
rtems_device_driver null_close(
|
|
rtems_device_major_number major RTEMS_UNUSED,
|
|
rtems_device_minor_number minor RTEMS_UNUSED,
|
|
void *pargp RTEMS_UNUSED
|
|
)
|
|
{
|
|
return NULL_SUCCESSFUL;
|
|
}
|
|
|
|
/* null_read
|
|
*
|
|
* This routine is the null device driver read routine.
|
|
*
|
|
* Input parameters:
|
|
* major - device major number
|
|
* minor - device minor number
|
|
* pargp - pointer to read parameter block
|
|
*
|
|
* Output parameters:
|
|
* rval - NULL_SUCCESSFUL
|
|
*/
|
|
|
|
rtems_device_driver null_read(
|
|
rtems_device_major_number major RTEMS_UNUSED,
|
|
rtems_device_minor_number minor RTEMS_UNUSED,
|
|
void *pargp RTEMS_UNUSED
|
|
)
|
|
{
|
|
return NULL_SUCCESSFUL;
|
|
}
|
|
|
|
/* null_write
|
|
*
|
|
* This routine is the null device driver write routine.
|
|
*
|
|
* Input parameters:
|
|
* major - device major number
|
|
* minor - device minor number
|
|
* pargp - pointer to write parameter block
|
|
*
|
|
* Output parameters:
|
|
* rval - NULL_SUCCESSFUL
|
|
*/
|
|
|
|
rtems_device_driver null_write(
|
|
rtems_device_major_number major RTEMS_UNUSED,
|
|
rtems_device_minor_number minor RTEMS_UNUSED,
|
|
void *pargp
|
|
)
|
|
{
|
|
rtems_libio_rw_args_t *rw_args = (rtems_libio_rw_args_t *) pargp;
|
|
|
|
if ( rw_args ) {
|
|
rw_args->bytes_moved = rw_args->count;
|
|
}
|
|
|
|
return NULL_SUCCESSFUL;
|
|
}
|
|
|
|
/* null_control
|
|
*
|
|
* This routine is the null device driver control routine.
|
|
*
|
|
* Input parameters:
|
|
* major - device major number
|
|
* minor - device minor number
|
|
* pargp - pointer to cntrl parameter block
|
|
*
|
|
* Output parameters:
|
|
* rval - NULL_SUCCESSFUL
|
|
*/
|
|
|
|
rtems_device_driver null_control(
|
|
rtems_device_major_number major RTEMS_UNUSED,
|
|
rtems_device_minor_number minor RTEMS_UNUSED,
|
|
void *pargp RTEMS_UNUSED
|
|
)
|
|
{
|
|
return NULL_SUCCESSFUL;
|
|
}
|