Nova-core Guidelines | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

guidelines.rst:1-24

Firmware-independent driver API와 second-level driver regression 기준을 정의합니다.

핵심 위치

항목내용

SourceDocumentation/gpu/nova/core/guidelines.rst

분량24 source lines

연결nova-drm · VFIO · GSP

문서의 중심 개념과 연결 지점입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 .. SPDX-License-Identifier: (GPL-2.0+ OR MIT)

3 ==========

4 Guidelines

5 ==========

7 This documents contains the guidelines for nova-core. Additionally, all common

8 guidelines of the Nova project do apply.

10 Driver API

11 ==========

13 One main purpose of nova-core is to implement the abstraction around the

14 firmware interface of GSP and provide a firmware (version) independent API for

15 2nd level drivers, such as nova-drm or the vGPU manager VFIO driver.

17 Therefore, it is not permitted to leak firmware (version) specifics, through the

18 driver API, to 2nd level drivers.

20 Acceptance Criteria

21 ===================

23 - To the extend possible, patches submitted to nova-core must be tested for

24 regressions with all 2nd level drivers.

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Nova-core API와 acceptance criteria

1-24

이 문서는 `nova-core` 전용 guideline을 정의하며 Nova project의 모든 공통 guideline도 함께 적용됩니다. 원문 SPDX 라이선스는 `(GPL-2.0+ OR MIT)`입니다.

`nova-core`의 주요 목적 가운데 하나는 GSP firmware interface를 추상화하고, `nova-drm`이나 vGPU manager VFIO driver 같은 second-level driver에 firmware version과 무관한 API를 제공하는 것입니다.

따라서 driver API를 통해 firmware version별 세부사항을 second-level driver로 누출해서는 안 됩니다.

Acceptance criterion으로, 가능한 범위에서 `nova-core`에 제출하는 patch는 모든 second-level driver를 대상으로 regression test해야 합니다.

Nova-core API 경계

GSP firmware와 version-specific interfacenova-core abstractionFirmware-version-independent driver APInova-drm·vGPU manager VFIO 등 second-level drivers

Firmware 차이를 core 안에 가두는 계층 구조입니다.

Patch acceptance

영역기준

APIFirmware/version 세부사항을 외부로 노출하지 않음

CompatibilitySecond-level driver에 안정된 abstraction 제공

Testing가능한 모든 second-level driver로 regression test

API와 test에서 지켜야 할 기준입니다.

.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)

==========
Guidelines
==========

This documents contains the guidelines for nova-core. Additionally, all common
guidelines of the Nova project do apply.

Driver API
==========

One main purpose of nova-core is to implement the abstraction around the
firmware interface of GSP and provide a firmware (version) independent API for
2nd level drivers, such as nova-drm or the vGPU manager VFIO driver.

Therefore, it is not permitted to leak firmware (version) specifics, through the
driver API, to 2nd level drivers.

Acceptance Criteria
===================

- To the extend possible, patches submitted to nova-core must be tested for
  regressions with all 2nd level drivers.