nuttx/sched/clock/clock_getres.c

98 lines
2.8 KiB
C
Raw Normal View History

/****************************************************************************
sched/clock: support using CLOCKFD to call clock_getres This patch extends CLOCKFD support to clock_getres(), allowing applications to query the resolution of PTP clocks through file descriptors using the standard POSIX clock API. Key changes include: 1. Move clock_getres() from libc to kernel: - Relocated from libs/libc/sched/clock_getres.c to sched/clock/ - Enables direct kernel-level file descriptor handling - Maintains POSIX compliance while adding CLOCKFD support 2. CLOCKFD support in clock_getres(): - Detects CLOCKFD-encoded clockids using CLOCKFD_TO_FD() check - Extracts file descriptor from clockid parameter - Validates file descriptor through fs_getfilep() - Issues PTP_CLOCK_GETRES ioctl to query clock resolution 3. PTP clock resolution query: - Retrieves resolution from PTP clock device via ioctl - Returns nanosecond-precision timing resolution - Enables applications to determine clock accuracy capabilities - Falls back to standard clock resolution for non-CLOCKFD clockids 4. Error handling: - Returns EINVAL for invalid CLOCKFD file descriptors - Properly manages file reference counting with fs_putfilep() - Maintains backward compatibility with existing clock types 5. Build system updates: - Updated libs/libc/sched/CMakeLists.txt and Make.defs - Updated sched/clock/CMakeLists.txt to include clock_getres.c - Ensures proper compilation in kernel context Usage example: int fd = open("/dev/ptp0", O_RDONLY); struct timespec res; clock_getres(CLOCKFD(fd), &res); /* Query PTP clock resolution */ printf("Resolution: %ld.%09ld sec\n", res.tv_sec, res.tv_nsec); close(fd); This completes the basic POSIX clock API support for dynamic PTP clocks, providing applications with comprehensive clock information access. Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
2025-03-20 22:46:44 +08:00
* sched/clock/clock_getres.c
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
/****************************************************************************
* Included Files
****************************************************************************/
#include <stdint.h>
#include <time.h>
#include <errno.h>
#include <nuttx/debug.h>
#include <nuttx/clock.h>
sched/clock: support using CLOCKFD to call clock_getres This patch extends CLOCKFD support to clock_getres(), allowing applications to query the resolution of PTP clocks through file descriptors using the standard POSIX clock API. Key changes include: 1. Move clock_getres() from libc to kernel: - Relocated from libs/libc/sched/clock_getres.c to sched/clock/ - Enables direct kernel-level file descriptor handling - Maintains POSIX compliance while adding CLOCKFD support 2. CLOCKFD support in clock_getres(): - Detects CLOCKFD-encoded clockids using CLOCKFD_TO_FD() check - Extracts file descriptor from clockid parameter - Validates file descriptor through fs_getfilep() - Issues PTP_CLOCK_GETRES ioctl to query clock resolution 3. PTP clock resolution query: - Retrieves resolution from PTP clock device via ioctl - Returns nanosecond-precision timing resolution - Enables applications to determine clock accuracy capabilities - Falls back to standard clock resolution for non-CLOCKFD clockids 4. Error handling: - Returns EINVAL for invalid CLOCKFD file descriptors - Properly manages file reference counting with fs_putfilep() - Maintains backward compatibility with existing clock types 5. Build system updates: - Updated libs/libc/sched/CMakeLists.txt and Make.defs - Updated sched/clock/CMakeLists.txt to include clock_getres.c - Ensures proper compilation in kernel context Usage example: int fd = open("/dev/ptp0", O_RDONLY); struct timespec res; clock_getres(CLOCKFD(fd), &res); /* Query PTP clock resolution */ printf("Resolution: %ld.%09ld sec\n", res.tv_sec, res.tv_nsec); close(fd); This completes the basic POSIX clock API support for dynamic PTP clocks, providing applications with comprehensive clock information access. Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
2025-03-20 22:46:44 +08:00
#include <nuttx/fs/fs.h>
#include <nuttx/timers/ptp_clock.h>
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: clock_getres
*
* Description:
* Clock Functions based on POSIX APIs
*
****************************************************************************/
int clock_getres(clockid_t clock_id, struct timespec *res)
{
clockid_t clock_type = clock_id & CLOCK_MASK;
int ret = OK;
sinfo("clock_id=%d, clock_type=%d\n", clock_id, clock_type);
switch (clock_type)
{
default:
serr("Returning ERROR\n");
set_errno(EINVAL);
ret = ERROR;
break;
case CLOCK_MONOTONIC:
case CLOCK_BOOTTIME:
case CLOCK_REALTIME:
case CLOCK_PROCESS_CPUTIME_ID:
case CLOCK_THREAD_CPUTIME_ID:
/* Form the timspec using clock resolution in nanoseconds */
res->tv_sec = 0;
res->tv_nsec = NSEC_PER_TICK;
!nuttx: drop redundant casts on tv_sec/tv_nsec and fix printf formats Now that time_t is unconditionally 64-bit (signed int64_t) and the struct timespec fields tv_sec / tv_nsec are wide enough on their own, the explicit (uint64_t)/(int64_t)/(int) casts that used to guard the multiplications and subtractions in *_us / *_ms / *_ns helpers are no longer needed. Drop them to keep the timekeeping math readable and consistent with the previous sclock_t/time_t cleanup. In the same spirit, this commit also: * Normalises the printf-style format specifiers and casts used to print tv_sec / tv_nsec / tv_usec values across arch/, drivers/, fs/, sched/ and libs/. The prior code was a mix of "%d"/"%u"/"%ld"/"%lu"/"%lld"/PRIu32/PRIu64 with matching (int)/(unsigned long)/(long long)/PRIu* casts; some formats truncated time_t on 32-bit hosts, others mismatched signedness or width. Replace all such cases with the portable POSIX-recommended forms: - tv_sec (time_t, signed, impl-defined width) -> %jd + (intmax_t) - tv_nsec (long, signed) -> %ld (no cast) - tv_usec (suseconds_t / long) -> %ld (no cast) Add #include <stdint.h> where required. * Drops a few stale `(FAR const time_t *)&ts.tv_sec` casts and related `(FAR struct tm *)` / `(const time_t *)` casts in gmtime_r() / localtime_r() / gmtime() callers; ts.tv_sec is plain time_t now and the casts only obscured the type. * Fixes one overflow in fs/procfs/fs_procfscritmon.c where all_time.tv_sec * 1000000 could overflow on 32-bit time_t before being multiplied again; cast to uint64_t at the start. No behavioural change. Signed-off-by: Xiang Xiao <xiaoxiang@xiaomi.com>
2026-05-17 14:30:05 +08:00
sinfo("Returning res=(%jd,%ld)\n",
(intmax_t)res->tv_sec, res->tv_nsec);
break;
sched/clock: support using CLOCKFD to call clock_getres This patch extends CLOCKFD support to clock_getres(), allowing applications to query the resolution of PTP clocks through file descriptors using the standard POSIX clock API. Key changes include: 1. Move clock_getres() from libc to kernel: - Relocated from libs/libc/sched/clock_getres.c to sched/clock/ - Enables direct kernel-level file descriptor handling - Maintains POSIX compliance while adding CLOCKFD support 2. CLOCKFD support in clock_getres(): - Detects CLOCKFD-encoded clockids using CLOCKFD_TO_FD() check - Extracts file descriptor from clockid parameter - Validates file descriptor through fs_getfilep() - Issues PTP_CLOCK_GETRES ioctl to query clock resolution 3. PTP clock resolution query: - Retrieves resolution from PTP clock device via ioctl - Returns nanosecond-precision timing resolution - Enables applications to determine clock accuracy capabilities - Falls back to standard clock resolution for non-CLOCKFD clockids 4. Error handling: - Returns EINVAL for invalid CLOCKFD file descriptors - Properly manages file reference counting with fs_putfilep() - Maintains backward compatibility with existing clock types 5. Build system updates: - Updated libs/libc/sched/CMakeLists.txt and Make.defs - Updated sched/clock/CMakeLists.txt to include clock_getres.c - Ensures proper compilation in kernel context Usage example: int fd = open("/dev/ptp0", O_RDONLY); struct timespec res; clock_getres(CLOCKFD(fd), &res); /* Query PTP clock resolution */ printf("Resolution: %ld.%09ld sec\n", res.tv_sec, res.tv_nsec); close(fd); This completes the basic POSIX clock API support for dynamic PTP clocks, providing applications with comprehensive clock information access. Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
2025-03-20 22:46:44 +08:00
#ifdef CONFIG_PTP_CLOCK
case CLOCK_FD:
{
FAR struct file *filep;
ret = ptp_clockid_to_filep(clock_id, &filep);
if (ret < 0)
{
return ret;
}
ret = file_ioctl(filep, PTP_CLOCK_GETRES, res);
file_put(filep);
sched/clock: support using CLOCKFD to call clock_getres This patch extends CLOCKFD support to clock_getres(), allowing applications to query the resolution of PTP clocks through file descriptors using the standard POSIX clock API. Key changes include: 1. Move clock_getres() from libc to kernel: - Relocated from libs/libc/sched/clock_getres.c to sched/clock/ - Enables direct kernel-level file descriptor handling - Maintains POSIX compliance while adding CLOCKFD support 2. CLOCKFD support in clock_getres(): - Detects CLOCKFD-encoded clockids using CLOCKFD_TO_FD() check - Extracts file descriptor from clockid parameter - Validates file descriptor through fs_getfilep() - Issues PTP_CLOCK_GETRES ioctl to query clock resolution 3. PTP clock resolution query: - Retrieves resolution from PTP clock device via ioctl - Returns nanosecond-precision timing resolution - Enables applications to determine clock accuracy capabilities - Falls back to standard clock resolution for non-CLOCKFD clockids 4. Error handling: - Returns EINVAL for invalid CLOCKFD file descriptors - Properly manages file reference counting with fs_putfilep() - Maintains backward compatibility with existing clock types 5. Build system updates: - Updated libs/libc/sched/CMakeLists.txt and Make.defs - Updated sched/clock/CMakeLists.txt to include clock_getres.c - Ensures proper compilation in kernel context Usage example: int fd = open("/dev/ptp0", O_RDONLY); struct timespec res; clock_getres(CLOCKFD(fd), &res); /* Query PTP clock resolution */ printf("Resolution: %ld.%09ld sec\n", res.tv_sec, res.tv_nsec); close(fd); This completes the basic POSIX clock API support for dynamic PTP clocks, providing applications with comprehensive clock information access. Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
2025-03-20 22:46:44 +08:00
}
break;
#endif
}
return ret;
}