{"id":18782095,"url":"https://github.com/gpuopen-librariesandsdks/mxgpu-virtualization","last_synced_at":"2025-08-30T08:31:33.342Z","repository":{"id":70276102,"uuid":"76459069","full_name":"GPUOpen-LibrariesAndSDKs/MxGPU-Virtualization","owner":"GPUOpen-LibrariesAndSDKs","description":null,"archived":false,"fork":false,"pushed_at":"2020-03-10T07:53:49.000Z","size":1246,"stargazers_count":193,"open_issues_count":39,"forks_count":89,"subscribers_count":43,"default_branch":"master","last_synced_at":"2024-12-19T04:06:25.978Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GPUOpen-LibrariesAndSDKs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-12-14T12:47:56.000Z","updated_at":"2024-11-30T05:40:33.000Z","dependencies_parsed_at":"2023-02-26T01:45:08.167Z","dependency_job_id":null,"html_url":"https://github.com/GPUOpen-LibrariesAndSDKs/MxGPU-Virtualization","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GPUOpen-LibrariesAndSDKs%2FMxGPU-Virtualization","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GPUOpen-LibrariesAndSDKs%2FMxGPU-Virtualization/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GPUOpen-LibrariesAndSDKs%2FMxGPU-Virtualization/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GPUOpen-LibrariesAndSDKs%2FMxGPU-Virtualization/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GPUOpen-LibrariesAndSDKs","download_url":"https://codeload.github.com/GPUOpen-LibrariesAndSDKs/MxGPU-Virtualization/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231461743,"owners_count":18380303,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T20:34:48.849Z","updated_at":"2025-08-30T08:31:33.334Z","avatar_url":"https://github.com/GPUOpen-LibrariesAndSDKs.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GIM\n\n# This repository has been replaced by https://github.com/amd/MxGPU-Virtualization. Please visit the new repository for support with current GPUs.\n\n```javascript\nCopyright (c) 2014-2019 Advanced Micro Devices, Inc. All rights reserved.\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE\n```\n## What is GIM?\n [GIM](https://github.com/GPUOpen-LibrariesAndSDKs/MxGPU-Virtualization) \n (GPU-IOV Module) is a Linux kernel module for AMD SR-IOV based HW\n Virtualization (MxGPU) product. It can support KVM, open source Xen and\n any other Linux kernel based hypervisors with necessary kernel compatibility\n modification. GIM is reponsible for: \n * GPU IOV initialization\n * Virtual function configuration and enablement\n * GPU scheduling for world switch\n * Hang detection and virtual function level reset (FLR)\n * PF/VF hand shake and other GPU utilities.\n\n Currently, only AMD S7150 series GPUs are supported.\n\n## DOCUMENTATION:\n All documents are listed in SRC_ROOT/docs\n \n## SOFTWARE REQUIREMENTS:\n * The tested host OS for GIM is Ubuntu16.04.2. All other\n hypervisor SW(KVM, XEN, QEMU, LIBVIRT) versions are aligned with default\n version of OS.\n\n GIM supports KVM in Ubuntu 16.04, and supports XEN in CentOS 7.3.\n\n Host OS     | Kernel            | KVM/Xen | QEMU  | libvirt\n ------------|-------------------|---------|-------|--------------\n Ubuntu 16.04.2 server | 4.4.0-75-generic  | KVM 4.4 | 2.5.0 | 1.3.1  |\n\n\n * The tested guest OS\n\n Guest OS  |  Distributions                                 \n ----------|-------------------------------------------------\n Linux     |  Ubuntu 16.04 LTS 64bit; CentOS 7.3 64 bit       \n Windows   |  Win7 64bit; Win10 TH2 64bit                   \n  \n\n * Some legacy Linux kernels have issues with enabling PCI SR-IOV.\n   It is suggested to use Ubuntu 4.4.0-75-generic kernel and apply the patch for \n   IOV module. The patch file can be found under SRC_ROOT/patch.\n\n## HOW TO BUILD \u0026 INSTALL:\n All driver source codes are under SRC_ROOT/drv.\n 1. Typing command \"make\" in terminal under SRC_ROOT/drv can generate gim.ko.\n 2. Typing command \"make install\" in terminal under SRC_ROOT/drv can install\n   gim.ko to /lib/modules/$(KERNELRELEASE)/GIM/.\n 3. Generally, Just run helper SRC_ROOT/gim.sh in a command terminal also can\n   completed build and installation. And gim.sh -help can display usages.\n 4. Blacklist amdgpu and amdkfd and reboot the server. Such as, under Ubuntu, \n   by adding the following line to the end of file /etc/modprobe.d/blacklist.conf\n   \n   ```\n   blacklist amdgpu\n   blacklist amdkfd\n   ```\n## HOW TO LOAD:\n 1. Typing command \"modprobe gim\" in terminal can load gim driver\n 2. Usually, Typing command \"lsmod | grep gim \" and \"lspci | grep AMD\" in\n   terminal can help to check if gim driver is loaded\n\n## HOW TO CONFIGURE BUILD:\n  Read this section carefully. New configuration options could be added in\n  each release, and unexpected problems can occur if the configuration files are\n  not set up as expected.\n\n  * Alternative configuration commands are\n \n        CONFIG_GIM_HEARTBEAT_TIMER\n                Heartbeat timer provides a useful way to display statistics\n                of GIM periodically for debug purpose.\n                Currently, it only counts the number of scheduler timer ticks\n                and world switches, if the configuration is defined.\n\n * Edit configuraiton in Makefile\n \n        GIM is an external kernel driver module. The driver configuration is\n        different from upstream kernel driver. Editing \"KBUILD_CFLAGS\" in\n        the Makefile is preferred to pass the configuration to GIM.\n\n## HISTORY:\n - 1.0 (2017/07/20)\n        The original release support AMD S7150 series.\n\n - 2.0 (2018/9/30)\n        Fix some issues for AMD S7150 series.\n\n - 3.0 (2019/3/28)\n\tAdding support for mixed guest OS.\n\tFix some issues for AMD S7150 series.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpuopen-librariesandsdks%2Fmxgpu-virtualization","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgpuopen-librariesandsdks%2Fmxgpu-virtualization","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpuopen-librariesandsdks%2Fmxgpu-virtualization/lists"}