Files
rtems/cpukit/libmisc/devnull/devzero.c
T
Sebastian Huber 7caa18eaec cpukit/libmisc: Fix the file groups
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>
2026-09-01 20:17:20 +00:00

108 lines
3.0 KiB
C

/* SPDX-License-Identifier: BSD-2-Clause */
/**
* @file
*
* @ingroup libmisc_devnull
*
* @brief Devzero
*/
/*
* Copyright (c) 2011 embedded brains GmbH & Co. KG
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include <rtems/devzero.h>
#include <string.h>
#include <rtems/libio.h>
rtems_device_driver dev_zero_initialize(
rtems_device_major_number major,
rtems_device_minor_number minor RTEMS_UNUSED,
void *arg RTEMS_UNUSED
)
{
return rtems_io_register_name( DEVZERO_DEVICE_NAME, major, 0 );
}
rtems_device_driver dev_zero_open(
rtems_device_major_number major RTEMS_UNUSED,
rtems_device_minor_number minor RTEMS_UNUSED,
void *arg RTEMS_UNUSED
)
{
return RTEMS_SUCCESSFUL;
}
rtems_device_driver dev_zero_close(
rtems_device_major_number major RTEMS_UNUSED,
rtems_device_minor_number minor RTEMS_UNUSED,
void *arg RTEMS_UNUSED
)
{
return RTEMS_SUCCESSFUL;
}
rtems_device_driver dev_zero_read(
rtems_device_major_number major RTEMS_UNUSED,
rtems_device_minor_number minor RTEMS_UNUSED,
void *arg RTEMS_UNUSED
)
{
rtems_libio_rw_args_t *rw = arg;
rw->bytes_moved = rw->count;
memset( rw->buffer, 0, rw->count );
return RTEMS_SUCCESSFUL;
}
rtems_device_driver dev_zero_write(
rtems_device_major_number major RTEMS_UNUSED,
rtems_device_minor_number minor RTEMS_UNUSED,
void *arg
)
{
rtems_libio_rw_args_t *rw = arg;
rw->bytes_moved = rw->count;
return RTEMS_SUCCESSFUL;
}
rtems_device_driver dev_zero_control(
rtems_device_major_number major RTEMS_UNUSED,
rtems_device_minor_number minor RTEMS_UNUSED,
void *arg RTEMS_UNUSED
)
{
return RTEMS_IO_ERROR;
}