nuttx/sched/clock/clock.h
Xiang Xiao c32b683085 !compiler: drop CONFIG_HAVE_LONG_LONG and require long long support
Every compiler supported by NuttX provides the "long long" types,
so the CONFIG_HAVE_LONG_LONG indirection is no longer useful.
Remove the option from include/nuttx/compiler.h and treat
"long long" as unconditionally available across the OS.

In addition to deleting the guard itself, this commit unconditionally
enables the long-long flavored helpers that used to be gated behind
it:

  - libs/libc/fixedmath: drop the soft-emulated b32/ub32 routines
    in lib_fixedmath.c (-261 lines) and trim the matching
    prototypes, Make.defs and CMakeLists.txt entries; keep only
    the long-long backed implementations.
  - include/sys/endian.h, include/strings.h, libs/libc/string
    /lib_ffsll.c, lib_flsll.c: always expose the 64-bit byte-swap
    and ffsll/flsll variants.
  - libs/libm/libm/lib_llround{,f,l}.c: drop the empty stubs.
  - libs/libc/stdlib (atoll, llabs, lldiv, strtoll/ull, rand48,
    strtold), libs/libc/stream (libvsprintf, libvscanf,
    libbsprintf, ultoa_invert), libs/libc/misc (crc64, crc64emac),
    libs/libc/inttypes/strtoimax, libs/libc/lzf, libs/libc/libc.csv,
    libs/libc/string (memset, vikmemcpy): remove the
    #ifdef CONFIG_HAVE_LONG_LONG branches.
  - include/{stddef.h,stdlib.h,fixedmath.h,sys/epoll.h,cxx/cstdlib,
    nuttx/audio/audio.h,nuttx/crc64.h,nuttx/lib/math.h,
    nuttx/lib/math32.h,nuttx/lib/stdbit.h}: same guard cleanup.
  - drivers/note/note_driver.c, fs/spiffs/src/spiffs.h,
    sched/irq/irq_procfs.c: drop their local guards as well.
  - Documentation/applications/netutils/ntpclient/index.rst:
    refresh the documentation snippet.

Signed-off-by: Xiang Xiao <xiaoxiang@xiaomi.com>
2026-05-19 16:21:28 +08:00

136 lines
4.4 KiB
C

/****************************************************************************
* sched/clock/clock.h
*
* 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.
*
****************************************************************************/
#ifndef __SCHED_CLOCK_CLOCK_H
#define __SCHED_CLOCK_CLOCK_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <stdint.h>
#include <nuttx/clock.h>
#include <nuttx/compiler.h>
#include <nuttx/spinlock_type.h>
/****************************************************************************
* Public Data
****************************************************************************/
#ifndef CONFIG_CLOCK_TIMEKEEPING
extern struct timespec g_basetime;
extern spinlock_t g_basetime_lock;
#endif
/****************************************************************************
* Public Function Prototypes
****************************************************************************/
/****************************************************************************
* Name: clock_basetime
*
* Description:
* Get the initial time value from the best source available.
*
****************************************************************************/
int clock_basetime(FAR struct timespec *tp);
/****************************************************************************
* Name: clock_initialize
*
* Description:
* Perform one-time initialization of the timing facilities.
*
****************************************************************************/
void clock_initialize(void);
/****************************************************************************
* Name: clock_update_sched_ticks
*
* Description:
* Update the scheduler tick counter to a specific value. This function
* directly sets the system tick counter to the given value (rather than
* incrementing it), typically used for synchronizing or resetting the
* scheduler tick count to a known state.
*
* Input Parameters:
* ticks - The new value to set for the scheduler tick counter
*
* Returned Value:
* None
*
****************************************************************************/
void clock_update_sched_ticks(clock_t ticks);
/****************************************************************************
* Name: clock_increase_sched_ticks
*
* Description:
* Increment the scheduler tick counter. This function should be called
* each time the real-time clock interrupt occurs, indicating the passage
* of one or more scheduling ticks.
*
* Input Parameters:
* ticks - The number of ticks to increment (typically 1)
*
* Returned Value:
* None
*
****************************************************************************/
void clock_increase_sched_ticks(clock_t ticks);
/****************************************************************************
* Name: clock_get_sched_ticks
*
* Description:
* Return the current value of the scheduler tick counter. This counter
* only increases while the scheduler is running, and is independent of
* the real-time clock.
*
* Returned Value:
* The current number of scheduler ticks.
*
****************************************************************************/
clock_t clock_get_sched_ticks(void);
#ifdef CONFIG_SCHED_CPULOAD_SYSCLK
/****************************************************************************
* Name: cpuload_init
*
* Description:
* Initialize the CPU load measurement logic.
*
****************************************************************************/
void cpuload_init(void);
#endif
#endif /* __SCHED_CLOCK_CLOCK_H */