From a874b29c40d660e3d36ab870b905a61acc327068 Mon Sep 17 00:00:00 2001 From: stubbybubby Date: Wed, 19 Apr 2017 11:09:28 -0700 Subject: [PATCH 1/2] Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences --- hardware/hcl.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/hardware/hcl.md b/hardware/hcl.md index 69749822..edde353a 100644 --- a/hardware/hcl.md +++ b/hardware/hcl.md @@ -13,18 +13,18 @@ redirect_from: Hardware Compatibility List (HCL) for All Qubes OS Releases =========================================================== -The [HCL](/hcl) is a compilation of reports generated and submitted by users across various Qubes versions. +The [HCL](/hcl) is a compilation of reports generated and submitted by users across various Qubes versions about their hardware's compatibility with Qubes. + **Note:** Except in the case of developer-reported entries, the Qubes team has not independently verified the accuracy of these reports. Please first consult the data sheets (CPU, chipset, motherboard) prior to buying new hardware for Qubes. - Meet the [System Requirements](/doc/system-requirements/) and search particular for support of: + Make sure it meets the [System Requirements](/doc/system-requirements/) and search in particular for support of: - HVM ("AMD virtualization (AMD-V)", "Intel virtualization (VT-x)", "VIA virtualization (VIA VT)") - IOMMU ("AMD I/O Virtualization Technology (AMD-Vi)", "Intel Virtualization Technology for Directed I/O (VT-d)") - TPM ("Trusted Platform Module (TPM)" connected to a "20-pin TPM header" on motherboards.) -Test the hardware yourself, if possible. - If using the list to make a purchasing decision, we recommend that you choose hardware with: +If using the list to make a purchasing decision, we recommend that you choose hardware with: - the best achievable Qubes security level (green columns in HVM, IOMMU, TPM) - and general machine compatibility (green columns in Qubes version, dom0 kernel, remarks). @@ -32,14 +32,15 @@ Test the hardware yourself, if possible. Generating and Submitting New Reports ------------------------------------- -In order to generate a HCL report in Qubes, simply open a terminal in dom0 (KDE: start-menu -\> System Tools -\> Konsole or Terminal Emulator) - and run `qubes-hcl-report `, where `` is the name of the VM to which the generated HCL files will be saved. - (Note: If you are working with a new Qubes installation, you may need to update your system in order to download this script.) +In order to generate a an HCL report in Qubes, simply open a terminal in dom0 (KDE: start-menu -\> System Tools -\> Konsole or Terminal Emulator) +and run `qubes-hcl-report `, where `` is the name of the VM to which the generated HCL files will be saved. +(Note: If you are working with a new Qubes installation, you may need to update your system in order to download this script.) You are encouraged to submit your HCL report for the benefit of further Qubes development and other users. - If you would like to submit your HCL report, please send the **HCL Info** `.yml` file to [\`qubes-users@googlegroups.com\`](/doc/mailing-lists/) with the subject `HCL - `. - Please include any useful information about any Qubes features you may have tested (see the legend below), as well as general machine compatibility (video, networking, sleep, etc.). - Please consider sending the **HCL Support Files** `.cpio.gz` file as well. To generate these add the `-s` or `--support` command line option. +When submitting reports, test the hardware yourself, if possible. +If you would like to submit your HCL report, please send the **HCL Info** `.yml` file to [\`qubes-users@googlegroups.com\`](/doc/mailing-lists/) with the subject `HCL - `. +Please include any useful information about any Qubes features you may have tested (see the legend below), as well as general machine compatibility (video, networking, sleep, etc.). +Please consider sending the **HCL Support Files** `.cpio.gz` file as well. To generate these add the `-s` or `--support` command line option. **Please note:** The **HCL Support Files** may contain numerous hardware details, including serial numbers. If, for privacy or security reasons, you do not wish to make this information public, please **do not** send the `.cpio.gz` file to the public mailing list. From eb6e303243cb47176adc0dae8f7301b4379ff15c Mon Sep 17 00:00:00 2001 From: Dean V Date: Mon, 24 Apr 2017 09:19:46 -0700 Subject: [PATCH 2/2] ;_; --- hardware/hcl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hardware/hcl.md b/hardware/hcl.md index edde353a..b48b9f94 100644 --- a/hardware/hcl.md +++ b/hardware/hcl.md @@ -32,7 +32,7 @@ If using the list to make a purchasing decision, we recommend that you choose ha Generating and Submitting New Reports ------------------------------------- -In order to generate a an HCL report in Qubes, simply open a terminal in dom0 (KDE: start-menu -\> System Tools -\> Konsole or Terminal Emulator) +In order to generate an HCL report in Qubes, simply open a terminal in dom0 (KDE: start-menu -\> System Tools -\> Konsole or Terminal Emulator) and run `qubes-hcl-report `, where `` is the name of the VM to which the generated HCL files will be saved. (Note: If you are working with a new Qubes installation, you may need to update your system in order to download this script.)