services/portability/posix/conformance/index.html · services/portability/posix/conformance/index.rst 공식 원문 ↗

Zephyr 3.7.0 · Portability · POSIX

POSIX Conformance

POSIX symbol별 support version, Kconfig gate와 undefined-behaviour 범위를 표준 기준으로 확인합니다.

Official pathservices/portability/posix/conformance/index.html
Source fileservices/portability/posix/conformance/index.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

필수·미지원·선택 interface, shell·utility와 X/Open 항목 73개를 6개 표로 정리합니다.

Standard

IEEE 1003.1-2017

Support

200809L · -1

Caution

† Undefined behaviour

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 146632FF853294235351FDD4247FAA473A072A0F71C428B6D48E54677E181FEC
.. _posix_conformance:

POSIX Conformance
#################

As per `IEEE 1003.1-2017`, this section details Zephyr's POSIX conformance.

.. _posix_system_interfaces:

POSIX System Interfaces
=======================

.. The following have values greater than -1 in Zephyr, conformant with the POSIX specification.

.. csv-table:: POSIX System Interfaces
   :header: Symbol, Support, Remarks
   :widths: 50, 10, 50

    _POSIX_CHOWN_RESTRICTED, 0,
    _POSIX_NO_TRUNC, 0,
    _POSIX_VDISABLE, ``'\0'``,

.. TODO: POSIX_ASYNCHRONOUS_IO, and other interfaces below, are mandatory. That means that a
   strictly conforming application need not be modified in order to compile against Zephyr.
   However, we may add implementations that simply fail with ENOSYS as long as the functional
   modification is clearly documented. The implementation is not required for PSE51 or PSE52
   and beyond that POSIX async I/O functions are rarely used in practice.

.. _posix_system_interfaces_required:

.. csv-table:: POSIX System Interfaces
   :header: Symbol, Support, Remarks
   :widths: 50, 10, 50

    _POSIX_VERSION, 200809L,
    :ref:`_POSIX_ASYNCHRONOUS_IO<posix_option_asynchronous_io>`, 200809L, :kconfig:option:`CONFIG_POSIX_ASYNCHRONOUS_IO`:ref:`†<posix_undefined_behaviour>`
    :ref:`_POSIX_BARRIERS<posix_option_group_barriers>`, 200809L, :kconfig:option:`CONFIG_POSIX_BARRIERS`
    :ref:`_POSIX_CLOCK_SELECTION<posix_option_group_clock_selection>`, 200809L, :kconfig:option:`CONFIG_POSIX_CLOCK_SELECTION`
    :ref:`_POSIX_MAPPED_FILES<posix_option_group_mapped_files>`, 200809L, :kconfig:option:`CONFIG_POSIX_MAPPED_FILES`
    :ref:`_POSIX_MEMORY_PROTECTION<posix_option_group_memory_protection>`, 200809L, :kconfig:option:`CONFIG_POSIX_MEMORY_PROTECTION` :ref:`†<posix_undefined_behaviour>`
    :ref:`_POSIX_READER_WRITER_LOCKS<posix_option_reader_writer_locks>`, 200809L, :kconfig:option:`CONFIG_POSIX_READER_WRITER_LOCKS`
    :ref:`_POSIX_REALTIME_SIGNALS<posix_option_group_realtime_signals>`, -1, :kconfig:option:`CONFIG_POSIX_REALTIME_SIGNALS`
    :ref:`_POSIX_SEMAPHORES<posix_option_group_semaphores>`, 200809L, :kconfig:option:`CONFIG_POSIX_SEMAPHORES`
    :ref:`_POSIX_SPIN_LOCKS<posix_option_group_spin_locks>`, 200809L, :kconfig:option:`CONFIG_POSIX_SPIN_LOCKS`
    :ref:`_POSIX_THREAD_SAFE_FUNCTIONS<posix_thread_safe_functions>`, -1, :kconfig:option:`CONFIG_POSIX_THREAD_SAFE_FUNCTIONS`
    :ref:`_POSIX_THREADS<posix_option_group_threads_base>`, -1, :kconfig:option:`CONFIG_POSIX_THREADS`
    :ref:`_POSIX_TIMEOUTS<posix_option_timeouts>`, 200809L, :kconfig:option:`CONFIG_POSIX_TIMEOUTS`
    :ref:`_POSIX_TIMERS<posix_option_group_timers>`, 200809L, :kconfig:option:`CONFIG_POSIX_TIMERS`
    _POSIX2_C_BIND, 200809L,

.. The following should be valued greater than zero in Zephyr, in order to be strictly conformant
    with the POSIX specification.

.. csv-table:: POSIX System Interfaces (Unsupported)
   :header: Symbol, Support, Remarks
   :widths: 50, 10, 50

    _POSIX_JOB_CONTROL, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX_REGEXP, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX_SAVED_IDS, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX_SHELL, -1, :ref:`†<posix_undefined_behaviour>`

.. csv-table:: POSIX System Interfaces (Optional)
   :header: Symbol, Support, Remarks
   :widths: 50, 10, 50

    _POSIX_ADVISORY_INFO, -1,
    :ref:`_POSIX_CPUTIME<posix_option_cputime>`, 200809L, :kconfig:option:`CONFIG_POSIX_CPUTIME`
    :ref:`_POSIX_FSYNC<posix_option_fsync>`, 200809L, :kconfig:option:`CONFIG_POSIX_FSYNC`
    :ref:`_POSIX_IPV6<posix_option_ipv6>`, 200809L, :kconfig:option:`CONFIG_POSIX_IPV6`
    :ref:`_POSIX_MEMLOCK <posix_option_memlock>`, 200809L, :kconfig:option:`CONFIG_POSIX_MEMLOCK` :ref:`†<posix_undefined_behaviour>`
    :ref:`_POSIX_MEMLOCK_RANGE <posix_option_memlock_range>`, 200809L, :kconfig:option:`CONFIG_POSIX_MEMLOCK_RANGE`
    :ref:`_POSIX_MESSAGE_PASSING<posix_option_message_passing>`, 200809L, :kconfig:option:`CONFIG_POSIX_MESSAGE_PASSING`
    :ref:`_POSIX_MONOTONIC_CLOCK<posix_option_monotonic_clock>`, 200809L, :kconfig:option:`CONFIG_POSIX_MONOTONIC_CLOCK`
    _POSIX_PRIORITIZED_IO, -1,
    :ref:`_POSIX_PRIORITY_SCHEDULING<posix_option_priority_scheduling>`, 200809L, :kconfig:option:`CONFIG_POSIX_PRIORITY_SCHEDULING`
    :ref:`_POSIX_RAW_SOCKETS<posix_option_raw_sockets>`, 200809L, :kconfig:option:`CONFIG_POSIX_RAW_SOCKETS`
    :ref:`_POSIX_SHARED_MEMORY_OBJECTS <posix_shared_memory_objects>`, 200809L, :kconfig:option:`CONFIG_POSIX_SHARED_MEMORY_OBJECTS`
    _POSIX_SPAWN, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX_SPORADIC_SERVER, -1, :ref:`†<posix_undefined_behaviour>`
    :ref:`_POSIX_SYNCHRONIZED_IO <posix_option_synchronized_io>`, -1, :kconfig:option:`CONFIG_POSIX_SYNCHRONIZED_IO`
    :ref:`_POSIX_THREAD_ATTR_STACKADDR<posix_option_thread_attr_stackaddr>`, 200809L, :kconfig:option:`CONFIG_POSIX_THREAD_ATTR_STACKADDR`
    :ref:`_POSIX_THREAD_ATTR_STACKSIZE<posix_option_thread_attr_stacksize>`, 200809L, :kconfig:option:`CONFIG_POSIX_THREAD_ATTR_STACKSIZE`
    :ref:`_POSIX_THREAD_CPUTIME <posix_option_thread_cputime>`, 200809L, :kconfig:option:`CONFIG_POSIX_CPUTIME`
    :ref:`_POSIX_THREAD_PRIO_INHERIT <posix_option_thread_prio_inherit>`, 200809L, :kconfig:option:`CONFIG_POSIX_THREAD_PRIO_INHERIT`
    :ref:`_POSIX_THREAD_PRIO_PROTECT <posix_option_thread_prio_protect>`, -1, :kconfig:option:`CONFIG_POSIX_THREAD_PRIO_PROTECT`
    :ref:`_POSIX_THREAD_PRIORITY_SCHEDULING <posix_option_thread_priority_scheduling>`, 200809L, :kconfig:option:`CONFIG_POSIX_THREAD_PRIORITY_SCHEDULING`
    _POSIX_THREAD_PROCESS_SHARED, -1,
    _POSIX_THREAD_SPORADIC_SERVER, -1,
    _POSIX_TRACE, -1,
    _POSIX_TRACE_EVENT_FILTER, -1,
    _POSIX_TRACE_INHERIT, -1,
    _POSIX_TRACE_LOG, -1,
    _POSIX_TYPED_MEMORY_OBJECTS, -1,
    _XOPEN_CRYPT, -1,
    _XOPEN_REALTIME, -1,
    _XOPEN_REALTIME_THREADS, -1,
    :ref:`_XOPEN_STREAMS<posix_option_xopen_streams>`, 200809L, :kconfig:option:`CONFIG_XOPEN_STREAMS`
    _XOPEN_UNIX, -1,


POSIX Shell and Utilities
=========================

Zephyr does not support a POSIX shell or utilities at this time.

.. csv-table:: POSIX Shell and Utilities
   :header: Symbol, Support, Remarks
   :widths: 50, 10, 50

    _POSIX2_C_DEV, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_CHAR_TERM, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_FORT_DEV, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_FORT_RUN, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_LOCALEDEF, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_PBS, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_PBS_ACCOUNTING, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_PBS_LOCATE, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_PBS_MESSAGE, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_PBS_TRACK, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_SW_DEV, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_UPE, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_UNIX, -1, :ref:`†<posix_undefined_behaviour>`
    _POSIX2_UUCP, -1, :ref:`†<posix_undefined_behaviour>`

XSI Conformance
###############

X/Open System Interfaces
========================

.. csv-table:: X/Open System Interfaces
   :header: Symbol, Support, Remarks
   :widths: 50, 10, 50

    :ref:`_POSIX_FSYNC<posix_option_fsync>`, 200809L, :kconfig:option:`CONFIG_POSIX_FSYNC`
    :ref:`_POSIX_THREAD_ATTR_STACKADDR<posix_option_thread_attr_stackaddr>`, 200809L, :kconfig:option:`CONFIG_POSIX_THREAD_ATTR_STACKADDR`
    :ref:`_POSIX_THREAD_ATTR_STACKSIZE<posix_option_thread_attr_stacksize>`, 200809L, :kconfig:option:`CONFIG_POSIX_THREAD_ATTR_STACKSIZE`
    _POSIX_THREAD_PROCESS_SHARED, -1,

.. _posix_undefined_behaviour:

.. note::
   Some features may exhibit undefined behaviour as they fall beyond the scope of Zephyr's current
   design and capabilities. For example, multi-processing, ad-hoc memory-mapping, multiple users,
   or regular expressions are features that are uncommon in low-footprint embedded systems.
   Such undefined behaviour is denoted with the † (obelus) symbol. Additional details
   :ref:`here <posix_option_groups>`.

.. _posix_libc_provided:

.. note::
    Features listed in various POSIX Options or Option Groups may be provided in whole or in part
    by a conformant C library implementation. This includes (but is not limited to) POSIX
    Extensions to the ISO C Standard (`CX`_).

.. _CX: https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap01.html

Part 3

한국어 전문 번역

IEEE 1003.1-2017을 기준으로 Zephyr의 POSIX conformance 상태를 정리합니다.

POSIX System Interfaces

다음 기본 symbol은 Zephyr에서 POSIX specification에 맞는 값을 가집니다.

POSIX System Interfaces
심볼지원비고
_POSIX_CHOWN_RESTRICTED0
_POSIX_NO_TRUNC0
_POSIX_VDISABLE'\0'

필수 System Interface 표입니다. 200809L은 POSIX.1-2008 수준의 구현을 뜻하고 -1은 현재 지원하지 않음을 뜻합니다. 일부 mandatory interface는 compile compatibility를 제공하더라도 실제 호출이 ENOSYS로 실패할 수 있으며 그 제한은 명시돼야 합니다.

POSIX System Interfaces
심볼지원비고
_POSIX_VERSION200809L
_POSIX_ASYNCHRONOUS_IO200809LCONFIG_POSIX_ASYNCHRONOUS_IO · †
_POSIX_BARRIERS200809LCONFIG_POSIX_BARRIERS
_POSIX_CLOCK_SELECTION200809LCONFIG_POSIX_CLOCK_SELECTION
_POSIX_MAPPED_FILES200809LCONFIG_POSIX_MAPPED_FILES
_POSIX_MEMORY_PROTECTION200809LCONFIG_POSIX_MEMORY_PROTECTION · †
_POSIX_READER_WRITER_LOCKS200809LCONFIG_POSIX_READER_WRITER_LOCKS
_POSIX_REALTIME_SIGNALS-1CONFIG_POSIX_REALTIME_SIGNALS
_POSIX_SEMAPHORES200809LCONFIG_POSIX_SEMAPHORES
_POSIX_SPIN_LOCKS200809LCONFIG_POSIX_SPIN_LOCKS
_POSIX_THREAD_SAFE_FUNCTIONS-1CONFIG_POSIX_THREAD_SAFE_FUNCTIONS
_POSIX_THREADS-1CONFIG_POSIX_THREADS
_POSIX_TIMEOUTS200809LCONFIG_POSIX_TIMEOUTS
_POSIX_TIMERS200809LCONFIG_POSIX_TIMERS
_POSIX2_C_BIND200809L

Strict conformance를 위해 양수 값이 필요하지만 현재 Zephyr 설계 범위에서 지원하지 않는 interface입니다.

POSIX System Interfaces (Unsupported)
심볼지원비고
_POSIX_JOB_CONTROL-1†
_POSIX_REGEXP-1†
_POSIX_SAVED_IDS-1†
_POSIX_SHELL-1†

선택 가능한 POSIX System Interface와 현재 support·Kconfig 상태입니다.

POSIX System Interfaces (Optional)
심볼지원비고
_POSIX_ADVISORY_INFO-1
_POSIX_CPUTIME200809LCONFIG_POSIX_CPUTIME
_POSIX_FSYNC200809LCONFIG_POSIX_FSYNC
_POSIX_IPV6200809LCONFIG_POSIX_IPV6
_POSIX_MEMLOCK200809LCONFIG_POSIX_MEMLOCK · †
_POSIX_MEMLOCK_RANGE200809LCONFIG_POSIX_MEMLOCK_RANGE
_POSIX_MESSAGE_PASSING200809LCONFIG_POSIX_MESSAGE_PASSING
_POSIX_MONOTONIC_CLOCK200809LCONFIG_POSIX_MONOTONIC_CLOCK
_POSIX_PRIORITIZED_IO-1
_POSIX_PRIORITY_SCHEDULING200809LCONFIG_POSIX_PRIORITY_SCHEDULING
_POSIX_RAW_SOCKETS200809LCONFIG_POSIX_RAW_SOCKETS
_POSIX_SHARED_MEMORY_OBJECTS200809LCONFIG_POSIX_SHARED_MEMORY_OBJECTS
_POSIX_SPAWN-1†
_POSIX_SPORADIC_SERVER-1†
_POSIX_SYNCHRONIZED_IO-1CONFIG_POSIX_SYNCHRONIZED_IO
_POSIX_THREAD_ATTR_STACKADDR200809LCONFIG_POSIX_THREAD_ATTR_STACKADDR
_POSIX_THREAD_ATTR_STACKSIZE200809LCONFIG_POSIX_THREAD_ATTR_STACKSIZE
_POSIX_THREAD_CPUTIME200809LCONFIG_POSIX_CPUTIME
_POSIX_THREAD_PRIO_INHERIT200809LCONFIG_POSIX_THREAD_PRIO_INHERIT
_POSIX_THREAD_PRIO_PROTECT-1CONFIG_POSIX_THREAD_PRIO_PROTECT
_POSIX_THREAD_PRIORITY_SCHEDULING200809LCONFIG_POSIX_THREAD_PRIORITY_SCHEDULING
_POSIX_THREAD_PROCESS_SHARED-1
_POSIX_THREAD_SPORADIC_SERVER-1
_POSIX_TRACE-1
_POSIX_TRACE_EVENT_FILTER-1
_POSIX_TRACE_INHERIT-1
_POSIX_TRACE_LOG-1
_POSIX_TYPED_MEMORY_OBJECTS-1
_XOPEN_CRYPT-1
_XOPEN_REALTIME-1
_XOPEN_REALTIME_THREADS-1
_XOPEN_STREAMS200809LCONFIG_XOPEN_STREAMS
_XOPEN_UNIX-1

POSIX Shell and Utilities

Zephyr는 현재 POSIX shell이나 POSIX utility를 지원하지 않습니다.

POSIX Shell and Utilities
심볼지원비고
_POSIX2_C_DEV-1†
_POSIX2_CHAR_TERM-1†
_POSIX2_FORT_DEV-1†
_POSIX2_FORT_RUN-1†
_POSIX2_LOCALEDEF-1†
_POSIX2_PBS-1†
_POSIX2_PBS_ACCOUNTING-1†
_POSIX2_PBS_LOCATE-1†
_POSIX2_PBS_MESSAGE-1†
_POSIX2_PBS_TRACK-1†
_POSIX2_SW_DEV-1†
_POSIX2_UPE-1†
_POSIX2_UNIX-1†
_POSIX2_UUCP-1†
XSI Conformance

X/Open System Interfaces

X/Open System Interfaces
심볼지원비고
_POSIX_FSYNC200809LCONFIG_POSIX_FSYNC
_POSIX_THREAD_ATTR_STACKADDR200809LCONFIG_POSIX_THREAD_ATTR_STACKADDR
_POSIX_THREAD_ATTR_STACKSIZE200809LCONFIG_POSIX_THREAD_ATTR_STACKSIZE
_POSIX_THREAD_PROCESS_SHARED-1

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.