You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by ac...@apache.org on 2026/10/17 22:27:54 UTC

(nuttx) branch master updated (a624bf27f7b -> 35bb2fb53d3)

This is an automated email from the ASF dual-hosted git repository.

acassis pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git


    from a624bf27f7b Documentation/examples: Add pages for sandbox and pffault.
     new 46c67a7b404 Documentation/qemu-armv8a: Describe the PL031 RTC.
     new 6c272124d90 Documentation/v9fs: Describe symbolic links.
     new 35bb2fb53d3 Documentation/v9fs: Correct the heading of the mount section.

The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 Documentation/os/filesystem/v9fs.rst                  | 15 +++++++++++++--
 .../platforms/arm64/qemu/boards/qemu-armv8a/index.rst | 19 +++++++++++++++++++
 2 files changed, 32 insertions(+), 2 deletions(-)


(nuttx) 02/03: Documentation/v9fs: Describe symbolic links.

Posted by ac...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 6c272124d90554f7839e92494c137dfadd38768f
Author: Marco Casaroli <ma...@gmail.com>
AuthorDate: Sat Oct 17 20:23:14 2026 +0200

    Documentation/v9fs: Describe symbolic links.
    
    V9FS follows symbolic links and supports readlink(), lstat(),
    symlink() and link() with CONFIG_FS_LINKS. The V9FS page did not
    describe links.
    
    Add a section about symbolic links: the option, the supported calls,
    the loop limit, O_NOFOLLOW and the absolute targets that are not
    followed.
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <ma...@gmail.com>
---
 Documentation/os/filesystem/v9fs.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Documentation/os/filesystem/v9fs.rst b/Documentation/os/filesystem/v9fs.rst
index f86ad98e5e5..0580518dd12 100644
--- a/Documentation/os/filesystem/v9fs.rst
+++ b/Documentation/os/filesystem/v9fs.rst
@@ -15,6 +15,17 @@ driver. The two currently available are:
   - **VIRTIO** -> ``CONFIG_V9FS_VIRTIO_9P=y``
   - **SOCKET** -> ``CONFIG_V9FS_SOCKET_9P=y``
 
+Symbolic Links
+==============
+
+With ``CONFIG_FS_LINKS``, V9FS follows the symbolic links on the server,
+and supports ``readlink()``, ``lstat()``, ``symlink()`` and ``link()``. A
+path follows at most ``SYMLOOP_MAX`` links, and a loop fails with
+``ELOOP``. ``open()`` with ``O_NOFOLLOW`` does not follow a link in the
+last component of the path. ``rm`` of a link removes the link, not its
+target. A link with an absolute target is not followed and fails with
+``ENOTSUP``, because the target is a path on the server.
+
 NFS Mount Command
 =================
 


(nuttx) 03/03: Documentation/v9fs: Correct the heading of the mount section.

Posted by ac...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 35bb2fb53d37c6d59c992dd9ad3746df26dd979d
Author: Marco Casaroli <ma...@gmail.com>
AuthorDate: Sat Oct 17 20:23:15 2026 +0200

    Documentation/v9fs: Correct the heading of the mount section.
    
    The section about the mount options of V9FS had the heading "NFS Mount
    Command", copied from the NFS page.
    
    Rename the heading to "V9FS Mount Command".
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <ma...@gmail.com>
---
 Documentation/os/filesystem/v9fs.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/os/filesystem/v9fs.rst b/Documentation/os/filesystem/v9fs.rst
index 0580518dd12..cd9962a2da4 100644
--- a/Documentation/os/filesystem/v9fs.rst
+++ b/Documentation/os/filesystem/v9fs.rst
@@ -26,8 +26,8 @@ last component of the path. ``rm`` of a link removes the link, not its
 target. A link with an absolute target is not followed and fails with
 ``ENOTSUP``, because the target is a path on the server.
 
-NFS Mount Command
-=================
+V9FS Mount Command
+==================
 
 In V9FS, we have some special parameters
 


(nuttx) 01/03: Documentation/qemu-armv8a: Describe the PL031 RTC.

Posted by ac...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 46c67a7b40418dcbe0d56b06061ee8245648943f
Author: Marco Casaroli <ma...@gmail.com>
AuthorDate: Sat Oct 17 20:22:42 2026 +0200

    Documentation/qemu-armv8a: Describe the PL031 RTC.
    
    qemu-armv8a can register the PL031 RTC of the QEMU virt machine, with
    the new options QEMU_RTC_PL031_BASE, QEMU_RTC_PL031_IRQ and
    QEMU_RTC_PL031_SYNC. The board page did not describe it.
    
    Add the PL031 to the device list and the feature table, and add an RTC
    section with the options to enable and what they do.
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <ma...@gmail.com>
---
 .../platforms/arm64/qemu/boards/qemu-armv8a/index.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/Documentation/platforms/arm64/qemu/boards/qemu-armv8a/index.rst b/Documentation/platforms/arm64/qemu/boards/qemu-armv8a/index.rst
index 675a02bb5f5..8da7d5f60df 100644
--- a/Documentation/platforms/arm64/qemu/boards/qemu-armv8a/index.rst
+++ b/Documentation/platforms/arm64/qemu/boards/qemu-armv8a/index.rst
@@ -10,6 +10,7 @@ hardware platform and provides support for these devices:
 * GICv2 and GICv3 interrupt controllers
 * ARM Generic Timer
 * PL011 UART controller
+* PL031 RTC (optional)
 
 Getting Started
 ===============
@@ -731,12 +732,30 @@ Interface      Controller   Driver/Component
 GIC            on-chip      interrupt controller
 PL011 UART     on-chip      serial port
 ARM TIMER      on-chip      system clock
+PL031 RTC      on-chip      RTC (optional)
 ============== ============ ======================
 
 
 The kernel currently does not support other hardware features on this
 QEMU platform.
 
+RTC
+===
+
+The QEMU ``virt`` machine has a PL031 RTC at ``0x09010000`` (SPI 2), which
+QEMU sets from the host clock. Without it, the system time starts at
+``CONFIG_START_YEAR``, and the files on a host share (v9fs, hostfs) seem to
+be from the future. Enable ``CONFIG_RTC``, ``CONFIG_RTC_DATETIME``,
+``CONFIG_RTC_DRIVER``, ``CONFIG_RTC_ARCH`` and ``CONFIG_RTC_PL031``. Then
+``up_rtc_initialize()`` registers the PL031 as the RTC of the system and as
+``/dev/rtc0``, and the system time starts at the host time.
+``CONFIG_QEMU_RTC_PL031_BASE`` and ``CONFIG_QEMU_RTC_PL031_IRQ`` give the
+address and the interrupt.
+
+The PL031 counts whole seconds, so the system time can start up to one
+second behind the host. With ``CONFIG_QEMU_RTC_PL031_SYNC``, the boot waits
+(up to one second) for the RTC second to change.
+
 Debugging with QEMU
 ===================