Add 'projects/rocm-smi-lib/' from commit '7dba992ebd1beef78ec78d0d2974d6aa531786ff'

git-subtree-dir: projects/rocm-smi-lib git-subtree-mainline: 25536e61be git-subtree-split: 7dba992ebd
2025-07-22 22:52:41 +00:00
parent 25536e61be 7dba992ebd
commit 2a52e3974d
184 changed files with 62289 additions and 0 deletions
@@ -0,0 +1,5 @@
+* @bill-shuzhou-liu @dmitrii-galantsev @charis-poag-amd @oliveiradan
+
+docs/* @ROCm/rocm-documentation
+*.md @ROCm/rocm-documentation
+*.rst @ROCm/rocm-documentation
@@ -0,0 +1,105 @@
+# Contributing to ROCm SMI #
+
+We welcome contributions to ROCm SMI.  
+Please follow these details to help ensure your contributions will be successfully accepted.
+
+## Issue Discussion ##
+
+Please use the GitHub Issues tab to notify us of issues.
+
+* Use your best judgement for issue creation. If your issue is already listed, upvote the issue and
+  comment or post to provide additional details, such as how you reproduced this issue.
+* If you're not sure if your issue is the same, err on the side of caution and file your issue.
+  You can add a comment to include the issue number (and link) for the similar issue. If we evaluate
+  your issue as being the same as the existing issue, we'll close the duplicate.
+* If your issue doesn't exist, use the issue template to file a new issue.
+  * When filing an issue, be sure to provide as much information as possible,
+    including your amdgpu driver version, GPUs used, and commands ran. This
+    helps reduce the time required to reproduce your issue.
+  * Set `export RSMI_LOGGING=1` before running the script. Then include the log
+    file located here: `/var/log/rocm_smi_lib/ROCm-SMI-lib.log`
+  * Check your issue regularly, as we may require additional information to successfully reproduce the
+    issue.
+* You may also open an issue to ask questions to the maintainers about whether a proposed change
+  meets the acceptance criteria, or to discuss an idea pertaining to the library.
+
+## Acceptance Criteria ##
+
+The goal of ROCm SMI project is to provide a simple CLI interface and a library
+for interacting with AMD GPUs.
+
+## Coding Style ##
+
+Please refer to `.clang-format`. It is suggested you use `pre-commit` tool.
+It mostly follows Google C++ formatting with 100 character line limit.
+
+## Pull Request Guidelines ##
+
+When you create a pull request, you should target the default branch. Our
+current default branch is the **develop** branch, which serves as our
+integration branch.
+
+### Deliverables ###
+
+For each new file in repository,
+Please include the licensing header
+
+    /*
+     * =============================================================================
+     * The University of Illinois/NCSA
+     * Open Source License (NCSA)
+     *
+     * Copyright (c) 2017-20XX, Advanced Micro Devices, Inc.
+     * All rights reserved.
+     *
+     * Developed by:
+     *
+     *                 AMD Research and AMD ROC Software Development
+     *
+     *                 Advanced Micro Devices, Inc.
+     *
+     *                 www.amd.com
+     *
+     * Permission is hereby granted, free of charge, to any person obtaining a copy
+     * of this software and associated documentation files (the "Software"), to
+     * deal with the Software without restriction, including without limitation
+     * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+     * and/or sell copies of the Software, and to permit persons to whom the
+     * Software is furnished to do so, subject to the following conditions:
+     *
+     *  - Redistributions of source code must retain the above copyright notice,
+     *    this list of conditions and the following disclaimers.
+     *  - Redistributions in binary form must reproduce the above copyright
+     *    notice, this list of conditions and the following disclaimers in
+     *    the documentation and/or other materials provided with the distribution.
+     *  - Neither the names of <Name of Development Group, Name of Institution>,
+     *    nor the names of its contributors may be used to endorse or promote
+     *    products derived from this Software without specific prior written
+     *    permission.
+     *
+     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+     * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+     * THE CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+     * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+     * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+     * DEALINGS WITH THE SOFTWARE.
+     *
+     */
+
+### Process ###
+
+* Reviewers are listed in the CODEOWNERS file
+* Code format guidelines
+
+ROCm SMI uses the clang-format tool for formatting code in source files.
+The formatting style is captured in .clang-format which is located at
+the root of ROCm SMI. These are different options to follow:
+
+   1. Using pre-commit and docker - `pre-commit run`
+   1. Using only clang-format - `clang-format -i \<path-to-the-source-file\>`
+
+## References ##
+
+1. [pre-commit](https://github.com/pre-commit/pre-commit)
+1. [clang-format](https://clang.llvm.org/docs/ClangFormat.html)
@@ -0,0 +1,18 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "pip" # See documentation for possible values
+    directory: "/docs/sphinx" # Location of package manifests
+    open-pull-requests-limit: 10
+    schedule:
+      interval: "monthly"
+    labels:
+      - "documentation"
+      - "dependencies"
+      - "ci:docs-only"
+    reviewers:
+      - "samjwu"
@@ -0,0 +1,5 @@
+disabled: false
+scmId: gh-emu-rocm
+branchesToScan:
+  - amd-staging
+  - amd-mainline
@@ -0,0 +1,15 @@
+name: Rocm Validation Suite KWS
+on:
+  push:
+    branches: [amd-staging, amd-mainline]
+  pull_request:
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+jobs:
+  kws:
+    if: ${{ github.event_name == 'pull_request' }}
+    uses: AMD-ROCm-Internal/rocm_ci_infra/.github/workflows/kws.yml@mainline
+    secrets: inherit
+    with:
+      pr_number: ${{github.event.pull_request.number}}
+      base_branch: ${{github.base_ref}}
@@ -0,0 +1,25 @@
+name: ROCm CI Caller  
+on:  
+  pull_request:  
+    branches: [amd-staging, release/rocm-rel-*, amd-mainline]  
+    types: [opened, reopened, synchronize]  
+  push:  
+    branches: [amd-mainline]  
+  workflow_dispatch:  
+  issue_comment:  
+    types: [created]  
+  
+jobs:  
+  call-workflow:  
+    if: github.event_name != 'issue_comment' ||(github.event_name == 'issue_comment' && github.event.issue.pull_request && (startsWith(github.event.comment.body, '!verify') || startsWith(github.event.comment.body, '!verify release') || startsWith(github.event.comment.body, '!verify retest')))  
+    uses: AMD-ROCm-Internal/rocm_ci_infra/.github/workflows/rocm_ci.yml@mainline
+    secrets: inherit  
+    with:  
+      input_sha: ${{github.event_name == 'pull_request' && github.event.pull_request.head.sha || (github.event_name == 'push' && github.sha) || (github.event_name == 'issue_comment' && github.event.issue.pull_request.head.sha) || github.sha}}  
+      input_pr_num: ${{github.event_name == 'pull_request' && github.event.pull_request.number || (github.event_name == 'issue_comment' && github.event.issue.number) || 0}}  
+      input_pr_url: ${{github.event_name == 'pull_request' && github.event.pull_request.html_url || (github.event_name == 'issue_comment' && github.event.issue.pull_request.html_url) || ''}}  
+      input_pr_title: ${{github.event_name == 'pull_request' && github.event.pull_request.title || (github.event_name == 'issue_comment' && github.event.issue.pull_request.title) || ''}}  
+      repository_name: ${{ github.repository }}  
+      base_ref: ${{github.event_name == 'pull_request' && github.event.pull_request.base.ref || (github.event_name == 'issue_comment' && github.event.issue.pull_request.base.ref) || github.ref}}  
+      trigger_event_type: ${{ github.event_name }}  
+      comment_text: ${{ github.event_name == 'issue_comment' && github.event.comment.body || '' }}