diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 4c34a0cca..b9aacae6d 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + name: CI on: diff --git a/.github/workflows/pr.yaml b/.github/workflows/pr.yaml index 2873799cd..47802a877 100644 --- a/.github/workflows/pr.yaml +++ b/.github/workflows/pr.yaml @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + # Actions to *only* run on GitHub pull requests name: PR diff --git a/.gitignore b/.gitignore index 1808e83b1..ea269623b 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,6 @@ +# Copyright 2024, UNSW +# SPDX-License-Identifier: BSD-2-Clause + build/ zig-out/ .zig-cache/ diff --git a/.reuse/dep5 b/.reuse/dep5 new file mode 100644 index 000000000..4076b5253 --- /dev/null +++ b/.reuse/dep5 @@ -0,0 +1,39 @@ +Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: libvmm +Source: https://github.com/au-ts/libvmm + +Files: + .gitmodules + build.zig.zon + examples/simple/build.zig.zon + examples/zig/build.zig.zon + examples/rust/Cargo.lock + examples/rust/.cargo/config + examples/rust/aarch64-microkit-minimal.json +Copyright: UNSW +License: BSD-2-Clause + +Files: + docs/assets/passthrough.svg + docs/assets/virtio_console_example.svg + examples/virtio-snd/docs/sound-structure.svg + examples/virtio-snd/docs/virtio-snd.svg +Copyright: UNSW +License: CC-BY-SA-4.0 + +Files: + */linux_config + */linux.dts + examples/*/images/linux + examples/*/board/*/linux + examples/framebuffer/board/odroidc4/linux_vu7c.dts + examples/framebuffer/board/odroidc4/linux_with_serial.dts +Copyright: Linux +License: GPL-2.0-or-later + +Files: + */buildroot_config + examples/*/images/rootfs.cpio.gz + examples/*/board/*/rootfs.cpio.gz +Copyright: Buildroot +License: GPL-2.0-or-later diff --git a/LICENSE b/LICENSE deleted file mode 100644 index 3035d0483..000000000 --- a/LICENSE +++ /dev/null @@ -1,25 +0,0 @@ -BSD 2-Clause License - -Copyright (c) 2023, Trustworthy Systems - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: - -1. Redistributions of source code must retain the above copyright notice, this - list of conditions and the following disclaimer. - -2. Redistributions in binary form must reproduce the above copyright notice, - this list of conditions and the following disclaimer in the documentation - and/or other materials provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 000000000..8fb49a1c1 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,20 @@ + + +# License + +The files in the libvmm project are released under standard +open source licenses, identified by [SPDX license tags][1]. See the individual file +headers for details, or use one of the publicly available SPDX tools to generate a bill +of materials. The directory [`LICENSES`][2] contains the text for all licenses +that are mentioned by files in this project. + +Code contributions to this project should be licensed under the [BSD-2-Clause] +license, and documentation under the [CC-BY-SA-4.0] license. + +[1]: https://spdx.org +[2]: LICENSES/ +[BSD-2-CLAUSE]: LICENSES/BSD-2-Clause.txt +[CC-BY-SA-4.0]: LICENSES/CC-BY-SA-4.0.txt diff --git a/LICENSES/BSD-2-Clause.txt b/LICENSES/BSD-2-Clause.txt new file mode 100644 index 000000000..b0bed5edf --- /dev/null +++ b/LICENSES/BSD-2-Clause.txt @@ -0,0 +1,9 @@ +Copyright + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/LICENSES/BSD-3-Clause.txt b/LICENSES/BSD-3-Clause.txt new file mode 100644 index 000000000..fe354c55b --- /dev/null +++ b/LICENSES/BSD-3-Clause.txt @@ -0,0 +1,11 @@ +Copyright + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. + +3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/LICENSES/CC-BY-SA-4.0.txt b/LICENSES/CC-BY-SA-4.0.txt new file mode 100644 index 000000000..f50cdd32a --- /dev/null +++ b/LICENSES/CC-BY-SA-4.0.txt @@ -0,0 +1,350 @@ +Creative Commons Attribution-ShareAlike 4.0 International Creative Commons +Corporation ("Creative Commons") is not a law firm and does not provide legal +services or legal advice. Distribution of Creative Commons public licenses +does not create a lawyer-client or other relationship. Creative Commons makes +its licenses and related information available on an "as-is" basis. Creative +Commons gives no warranties regarding its licenses, any material licensed +under their terms and conditions, or any related information. Creative Commons +disclaims all liability for damages resulting from their use to the fullest +extent possible. + +Using Creative Commons Public Licenses + +Creative Commons public licenses provide a standard set of terms and conditions +that creators and other rights holders may use to share original works of +authorship and other material subject to copyright and certain other rights +specified in the public license below. The following considerations are for +informational purposes only, are not exhaustive, and do not form part of our +licenses. + +Considerations for licensors: Our public licenses are intended for use by +those authorized to give the public permission to use material in ways otherwise +restricted by copyright and certain other rights. Our licenses are irrevocable. +Licensors should read and understand the terms and conditions of the license +they choose before applying it. Licensors should also secure all rights necessary +before applying our licenses so that the public can reuse the material as +expected. Licensors should clearly mark any material not subject to the license. +This includes other CC-licensed material, or material used under an exception +or limitation to copyright. More considerations for licensors : wiki.creativecommons.org/Considerations_for_licensors + +Considerations for the public: By using one of our public licenses, a licensor +grants the public permission to use the licensed material under specified +terms and conditions. If the licensor's permission is not necessary for any +reason–for example, because of any applicable exception or limitation to copyright–then +that use is not regulated by the license. Our licenses grant only permissions +under copyright and certain other rights that a licensor has authority to +grant. Use of the licensed material may still be restricted for other reasons, +including because others have copyright or other rights in the material. A +licensor may make special requests, such as asking that all changes be marked +or described. + +Although not required by our licenses, you are encouraged to respect those +requests where reasonable. More considerations for the public : wiki.creativecommons.org/Considerations_for_licensees + +Creative Commons Attribution-ShareAlike 4.0 International Public License + +By exercising the Licensed Rights (defined below), You accept and agree to +be bound by the terms and conditions of this Creative Commons Attribution-ShareAlike +4.0 International Public License ("Public License"). To the extent this Public +License may be interpreted as a contract, You are granted the Licensed Rights +in consideration of Your acceptance of these terms and conditions, and the +Licensor grants You such rights in consideration of benefits the Licensor +receives from making the Licensed Material available under these terms and +conditions. + +Section 1 – Definitions. + +a. Adapted Material means material subject to Copyright and Similar Rights +that is derived from or based upon the Licensed Material and in which the +Licensed Material is translated, altered, arranged, transformed, or otherwise +modified in a manner requiring permission under the Copyright and Similar +Rights held by the Licensor. For purposes of this Public License, where the +Licensed Material is a musical work, performance, or sound recording, Adapted +Material is always produced where the Licensed Material is synched in timed +relation with a moving image. + +b. Adapter's License means the license You apply to Your Copyright and Similar +Rights in Your contributions to Adapted Material in accordance with the terms +and conditions of this Public License. + +c. BY-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, +approved by Creative Commons as essentially the equivalent of this Public +License. + +d. Copyright and Similar Rights means copyright and/or similar rights closely +related to copyright including, without limitation, performance, broadcast, +sound recording, and Sui Generis Database Rights, without regard to how the +rights are labeled or categorized. For purposes of this Public License, the +rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights. + +e. Effective Technological Measures means those measures that, in the absence +of proper authority, may not be circumvented under laws fulfilling obligations +under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, +and/or similar international agreements. + +f. Exceptions and Limitations means fair use, fair dealing, and/or any other +exception or limitation to Copyright and Similar Rights that applies to Your +use of the Licensed Material. + +g. License Elements means the license attributes listed in the name of a Creative +Commons Public License. The License Elements of this Public License are Attribution +and ShareAlike. + +h. Licensed Material means the artistic or literary work, database, or other +material to which the Licensor applied this Public License. + +i. Licensed Rights means the rights granted to You subject to the terms and +conditions of this Public License, which are limited to all Copyright and +Similar Rights that apply to Your use of the Licensed Material and that the +Licensor has authority to license. + +j. Licensor means the individual(s) or entity(ies) granting rights under this +Public License. + +k. Share means to provide material to the public by any means or process that +requires permission under the Licensed Rights, such as reproduction, public +display, public performance, distribution, dissemination, communication, or +importation, and to make material available to the public including in ways +that members of the public may access the material from a place and at a time +individually chosen by them. + +l. Sui Generis Database Rights means rights other than copyright resulting +from Directive 96/9/EC of the European Parliament and of the Council of 11 +March 1996 on the legal protection of databases, as amended and/or succeeded, +as well as other essentially equivalent rights anywhere in the world. + +m. You means the individual or entity exercising the Licensed Rights under +this Public License. Your has a corresponding meaning. + +Section 2 – Scope. + + a. License grant. + +1. Subject to the terms and conditions of this Public License, the Licensor +hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, +irrevocable license to exercise the Licensed Rights in the Licensed Material +to: + + A. reproduce and Share the Licensed Material, in whole or in part; and + + B. produce, reproduce, and Share Adapted Material. + +2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions +and Limitations apply to Your use, this Public License does not apply, and +You do not need to comply with its terms and conditions. + + 3. Term. The term of this Public License is specified in Section 6(a). + +4. Media and formats; technical modifications allowed. The Licensor authorizes +You to exercise the Licensed Rights in all media and formats whether now known +or hereafter created, and to make technical modifications necessary to do +so. The Licensor waives and/or agrees not to assert any right or authority +to forbid You from making technical modifications necessary to exercise the +Licensed Rights, including technical modifications necessary to circumvent +Effective Technological Measures. For purposes of this Public License, simply +making modifications authorized by this Section 2(a)(4) never produces Adapted +Material. + + 5. Downstream recipients. + +A. Offer from the Licensor – Licensed Material. Every recipient of the Licensed +Material automatically receives an offer from the Licensor to exercise the +Licensed Rights under the terms and conditions of this Public License. + +B. Additional offer from the Licensor – Adapted Material. Every recipient +of Adapted Material from You automatically receives an offer from the Licensor +to exercise the Licensed Rights in the Adapted Material under the conditions +of the Adapter's License You apply. + +C. No downstream restrictions. You may not offer or impose any additional +or different terms or conditions on, or apply any Effective Technological +Measures to, the Licensed Material if doing so restricts exercise of the Licensed +Rights by any recipient of the Licensed Material. + +6. No endorsement. Nothing in this Public License constitutes or may be construed +as permission to assert or imply that You are, or that Your use of the Licensed +Material is, connected with, or sponsored, endorsed, or granted official status +by, the Licensor or others designated to receive attribution as provided in +Section 3(a)(1)(A)(i). + + b. Other rights. + +1. Moral rights, such as the right of integrity, are not licensed under this +Public License, nor are publicity, privacy, and/or other similar personality +rights; however, to the extent possible, the Licensor waives and/or agrees +not to assert any such rights held by the Licensor to the limited extent necessary +to allow You to exercise the Licensed Rights, but not otherwise. + +2. Patent and trademark rights are not licensed under this Public License. + +3. To the extent possible, the Licensor waives any right to collect royalties +from You for the exercise of the Licensed Rights, whether directly or through +a collecting society under any voluntary or waivable statutory or compulsory +licensing scheme. In all other cases the Licensor expressly reserves any right +to collect such royalties. + +Section 3 – License Conditions. + +Your exercise of the Licensed Rights is expressly made subject to the following +conditions. + + a. Attribution. + +1. If You Share the Licensed Material (including in modified form), You must: + +A. retain the following if it is supplied by the Licensor with the Licensed +Material: + +i. identification of the creator(s) of the Licensed Material and any others +designated to receive attribution, in any reasonable manner requested by the +Licensor (including by pseudonym if designated); + + ii. a copyright notice; + + iii. a notice that refers to this Public License; + + iv. a notice that refers to the disclaimer of warranties; + +v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable; + +B. indicate if You modified the Licensed Material and retain an indication +of any previous modifications; and + +C. indicate the Licensed Material is licensed under this Public License, and +include the text of, or the URI or hyperlink to, this Public License. + +2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner +based on the medium, means, and context in which You Share the Licensed Material. +For example, it may be reasonable to satisfy the conditions by providing a +URI or hyperlink to a resource that includes the required information. + +3. If requested by the Licensor, You must remove any of the information required +by Section 3(a)(1)(A) to the extent reasonably practicable. + +b. ShareAlike.In addition to the conditions in Section 3(a), if You Share +Adapted Material You produce, the following conditions also apply. + +1. The Adapter's License You apply must be a Creative Commons license with +the same License Elements, this version or later, or a BY-SA Compatible License. + +2. You must include the text of, or the URI or hyperlink to, the Adapter's +License You apply. You may satisfy this condition in any reasonable manner +based on the medium, means, and context in which You Share Adapted Material. + +3. You may not offer or impose any additional or different terms or conditions +on, or apply any Effective Technological Measures to, Adapted Material that +restrict exercise of the rights granted under the Adapter's License You apply. + +Section 4 – Sui Generis Database Rights. + +Where the Licensed Rights include Sui Generis Database Rights that apply to +Your use of the Licensed Material: + +a. for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, +reuse, reproduce, and Share all or a substantial portion of the contents of +the database; + +b. if You include all or a substantial portion of the database contents in +a database in which You have Sui Generis Database Rights, then the database +in which You have Sui Generis Database Rights (but not its individual contents) +is Adapted Material, including for purposes of Section 3(b); and + +c. You must comply with the conditions in Section 3(a) if You Share all or +a substantial portion of the contents of the database. + +For the avoidance of doubt, this Section 4 supplements and does not replace +Your obligations under this Public License where the Licensed Rights include +other Copyright and Similar Rights. + +Section 5 – Disclaimer of Warranties and Limitation of Liability. + +a. Unless otherwise separately undertaken by the Licensor, to the extent possible, +the Licensor offers the Licensed Material as-is and as-available, and makes +no representations or warranties of any kind concerning the Licensed Material, +whether express, implied, statutory, or other. This includes, without limitation, +warranties of title, merchantability, fitness for a particular purpose, non-infringement, +absence of latent or other defects, accuracy, or the presence or absence of +errors, whether or not known or discoverable. Where disclaimers of warranties +are not allowed in full or in part, this disclaimer may not apply to You. + +b. To the extent possible, in no event will the Licensor be liable to You +on any legal theory (including, without limitation, negligence) or otherwise +for any direct, special, indirect, incidental, consequential, punitive, exemplary, +or other losses, costs, expenses, or damages arising out of this Public License +or use of the Licensed Material, even if the Licensor has been advised of +the possibility of such losses, costs, expenses, or damages. Where a limitation +of liability is not allowed in full or in part, this limitation may not apply +to You. + +c. The disclaimer of warranties and limitation of liability provided above +shall be interpreted in a manner that, to the extent possible, most closely +approximates an absolute disclaimer and waiver of all liability. + +Section 6 – Term and Termination. + +a. This Public License applies for the term of the Copyright and Similar Rights +licensed here. However, if You fail to comply with this Public License, then +Your rights under this Public License terminate automatically. + +b. Where Your right to use the Licensed Material has terminated under Section +6(a), it reinstates: + +1. automatically as of the date the violation is cured, provided it is cured +within 30 days of Your discovery of the violation; or + + 2. upon express reinstatement by the Licensor. + +c. For the avoidance of doubt, this Section 6(b) does not affect any right +the Licensor may have to seek remedies for Your violations of this Public +License. + +d. For the avoidance of doubt, the Licensor may also offer the Licensed Material +under separate terms or conditions or stop distributing the Licensed Material +at any time; however, doing so will not terminate this Public License. + + e. Sections 1, 5, 6, 7, and 8 survive termination of this Public License. + +Section 7 – Other Terms and Conditions. + +a. The Licensor shall not be bound by any additional or different terms or +conditions communicated by You unless expressly agreed. + +b. Any arrangements, understandings, or agreements regarding the Licensed +Material not stated herein are separate from and independent of the terms +and conditions of this Public License. + +Section 8 – Interpretation. + +a. For the avoidance of doubt, this Public License does not, and shall not +be interpreted to, reduce, limit, restrict, or impose conditions on any use +of the Licensed Material that could lawfully be made without permission under +this Public License. + +b. To the extent possible, if any provision of this Public License is deemed +unenforceable, it shall be automatically reformed to the minimum extent necessary +to make it enforceable. If the provision cannot be reformed, it shall be severed +from this Public License without affecting the enforceability of the remaining +terms and conditions. + +c. No term or condition of this Public License will be waived and no failure +to comply consented to unless expressly agreed to by the Licensor. + +d. Nothing in this Public License constitutes or may be interpreted as a limitation +upon, or waiver of, any privileges and immunities that apply to the Licensor +or You, including from the legal processes of any jurisdiction or authority. + +Creative Commons is not a party to its public licenses. Notwithstanding, Creative +Commons may elect to apply one of its public licenses to material it publishes +and in those instances will be considered the "Licensor." The text of the +Creative Commons public licenses is dedicated to the public domain under the +CC0 Public Domain Dedication. Except for the limited purpose of indicating +that material is shared under a Creative Commons public license or as otherwise +permitted by the Creative Commons policies published at creativecommons.org/policies, +Creative Commons does not authorize the use of the trademark "Creative Commons" +or any other trademark or logo of Creative Commons without its prior written +consent including, without limitation, in connection with any unauthorized +modifications to any of its public licenses or any other arrangements, understandings, +or agreements concerning use of licensed material. For the avoidance of doubt, +this paragraph does not form part of the public licenses. + +Creative Commons may be contacted at creativecommons.org. diff --git a/LICENSES/GPL-2.0-or-later.txt b/LICENSES/GPL-2.0-or-later.txt new file mode 100644 index 000000000..17cb28643 --- /dev/null +++ b/LICENSES/GPL-2.0-or-later.txt @@ -0,0 +1,117 @@ +GNU GENERAL PUBLIC LICENSE +Version 2, June 1991 + +Copyright (C) 1989, 1991 Free Software Foundation, Inc. +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + +Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. + +Preamble + +The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead.) You can apply it to your programs, too. + +When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. + +To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. + +For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. + +We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. + +Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. + +Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. + +The precise terms and conditions for copying, distribution and modification follow. + +TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + +0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. + +1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. + +You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. + +2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. + + c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. + +3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. + +If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. + +4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. + +5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. + +6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. + +7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. + +This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. + +8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. + +9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. + +10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. + +NO WARRANTY + +11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + +END OF TERMS AND CONDITIONS + +How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. + + one line to give the program's name and an idea of what it does. Copyright (C) yyyy name of author + + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. + + This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. + +signature of Ty Coon, 1 April 1989 Ty Coon, President of Vice diff --git a/LICENSES/MIT.txt b/LICENSES/MIT.txt new file mode 100644 index 000000000..2942df207 --- /dev/null +++ b/LICENSES/MIT.txt @@ -0,0 +1,7 @@ +Copyright + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in 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: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +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 AUTHORS 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 IN THE SOFTWARE. diff --git a/README.md b/README.md index b4326397b..bd2414cd2 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,8 @@ + + # libvmm The purpose of this project is to make it easy to run virtual machines on top of the seL4 microkernel. diff --git a/build.zig b/build.zig index 7c0f3ec2e..4ad83f380 100644 --- a/build.zig +++ b/build.zig @@ -1,3 +1,6 @@ +// Copyright 2024, UNSW +// SPDX-License-Identifier: BSD-2-Clause + const std = @import("std"); const src = [_][]const u8{ diff --git a/ci/README.md b/ci/README.md index ac16ffbc1..5601247f5 100644 --- a/ci/README.md +++ b/ci/README.md @@ -1,3 +1,8 @@ + + # CI for the VMM This basic CI attempts to build and run systems using the VMM in order to give diff --git a/ci/acquire_sdk.sh b/ci/acquire_sdk.sh index 5d65e1c68..9f07dfbe9 100755 --- a/ci/acquire_sdk.sh +++ b/ci/acquire_sdk.sh @@ -1,5 +1,9 @@ #!/bin/bash +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + set -x if ! command -v jq &> /dev/null diff --git a/ci/buildroot_login.exp b/ci/buildroot_login.exp index 60df9a3e9..d69e65a64 100755 --- a/ci/buildroot_login.exp +++ b/ci/buildroot_login.exp @@ -1,5 +1,9 @@ #!/usr/bin/env -S expect -f +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + set IMAGE [lindex $argv 0] # Wait enough (forever) until a long-time boot diff --git a/ci/examples.sh b/ci/examples.sh index 7ce32f07d..c16691b21 100755 --- a/ci/examples.sh +++ b/ci/examples.sh @@ -1,5 +1,9 @@ #!/bin/bash +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + set -e SDK_PATH=$1 diff --git a/docs/INTERFACE.md b/docs/INTERFACE.md index cdbce9830..e5514aae4 100644 --- a/docs/INTERFACE.md +++ b/docs/INTERFACE.md @@ -1,3 +1,8 @@ + + # Virtual machine Library The virtual machine library provides the following interfaces: diff --git a/docs/MANUAL.md b/docs/MANUAL.md index 41400ca77..cbae7d235 100644 --- a/docs/MANUAL.md +++ b/docs/MANUAL.md @@ -1,3 +1,8 @@ + + --- title: libvmm User Manual (v0.1) papersize: diff --git a/docs/README.md b/docs/README.md index 7b1ee5c70..62ff29ecb 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,3 +1,8 @@ + + # Manual ## Dependencies diff --git a/docs/shell.nix b/docs/shell.nix index 5fdfe56a0..1c6e1fbca 100644 --- a/docs/shell.nix +++ b/docs/shell.nix @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + let pkgs = import {}; in diff --git a/examples/rust/Cargo.toml b/examples/rust/Cargo.toml index ea1b6c399..00c68768b 100644 --- a/examples/rust/Cargo.toml +++ b/examples/rust/Cargo.toml @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + [package] name = "vmm" version = "0.1.0" diff --git a/examples/rust/README.md b/examples/rust/README.md index 7bcf82d66..e71741464 100644 --- a/examples/rust/README.md +++ b/examples/rust/README.md @@ -1,3 +1,8 @@ + + # Rust VMM example This example shows how to use the diff --git a/examples/rust/build.rs b/examples/rust/build.rs index 1cd969cc7..9c6a42178 100644 --- a/examples/rust/build.rs +++ b/examples/rust/build.rs @@ -1,10 +1,13 @@ +// Copyright 2024, UNSW +// SPDX-License-Identifier: BSD-2-Clause + fn main() { // Our VMM needs to link with libmicrokit, this is how we tell Cargo where to look for it. match std::env::var("MICROKIT_BOARD_DIR") { Ok(microkit_board_dir) => println!("cargo:rustc-link-search={microkit_board_dir}/lib"), Err(e) => println!("Could not get environment variable 'MICROKIT_BOARD_DIR': {e}"), } - // Our VMM needs to link with libvmm, this is how we tell Cargo where to look for it. + match std::env::var("BUILD_DIR") { Ok(build_dir) => println!("cargo:rustc-link-search={build_dir}"), Err(e) => println!("Could not get environment variable 'BUILD_DIR': {e}"), diff --git a/examples/rust/images/README.md b/examples/rust/images/README.md index b7499021f..e1ca2d2ba 100644 --- a/examples/rust/images/README.md +++ b/examples/rust/images/README.md @@ -1,3 +1,8 @@ + + # QEMU virt AArch64 images ## Linux kernel diff --git a/examples/rust/rust-toolchain.toml b/examples/rust/rust-toolchain.toml index fbf656b57..a16ff68e5 100644 --- a/examples/rust/rust-toolchain.toml +++ b/examples/rust/rust-toolchain.toml @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + [toolchain] channel = "nightly-2024-01-06" components = [ "rustfmt", "rust-src" ] diff --git a/examples/rust/src/vmm.rs b/examples/rust/src/vmm.rs index 88e25b206..1130a506a 100644 --- a/examples/rust/src/vmm.rs +++ b/examples/rust/src/vmm.rs @@ -1,3 +1,6 @@ +// Copyright 2024, UNSW +// SPDX-License-Identifier: BSD-2-Clause + #![no_std] #![no_main] #![feature(never_type)] diff --git a/examples/simple/README.md b/examples/simple/README.md index 49eb8bc9b..aaace3755 100644 --- a/examples/simple/README.md +++ b/examples/simple/README.md @@ -1,3 +1,8 @@ + + # A simple VMM for running Linux guests This example is a minimal VMM that supports Linux guests and a basic diff --git a/examples/simple/board/maaxboard/README.md b/examples/simple/board/maaxboard/README.md index c9d9fefc3..1adc4b061 100644 --- a/examples/simple/board/maaxboard/README.md +++ b/examples/simple/board/maaxboard/README.md @@ -1,4 +1,9 @@ -# QEMU virt AArch64 images + + +# MaaXBoard images ## Linux kernel diff --git a/examples/simple/board/maaxboard/overlay.dts b/examples/simple/board/maaxboard/overlay.dts index f424b4d93..4a373317d 100644 --- a/examples/simple/board/maaxboard/overlay.dts +++ b/examples/simple/board/maaxboard/overlay.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { memory@40000000 { device_type = "memory"; diff --git a/examples/simple/board/odroidc4/README.md b/examples/simple/board/odroidc4/README.md index 93ca6509a..7322ee86d 100644 --- a/examples/simple/board/odroidc4/README.md +++ b/examples/simple/board/odroidc4/README.md @@ -1,3 +1,8 @@ + + # Odroid-C4 images ## Linux kernel diff --git a/examples/simple/board/odroidc4/overlay.dts b/examples/simple/board/odroidc4/overlay.dts index e69de29bb..9c1d05ff9 100644 --- a/examples/simple/board/odroidc4/overlay.dts +++ b/examples/simple/board/odroidc4/overlay.dts @@ -0,0 +1,5 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ diff --git a/examples/simple/board/qemu_arm_virt/overlay.dts b/examples/simple/board/qemu_arm_virt/overlay.dts new file mode 100644 index 000000000..9c1d05ff9 --- /dev/null +++ b/examples/simple/board/qemu_arm_virt/overlay.dts @@ -0,0 +1,5 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ diff --git a/examples/simple/board/qemu_virt_aarch64/README.md b/examples/simple/board/qemu_virt_aarch64/README.md index b7499021f..e1ca2d2ba 100644 --- a/examples/simple/board/qemu_virt_aarch64/README.md +++ b/examples/simple/board/qemu_virt_aarch64/README.md @@ -1,3 +1,8 @@ + + # QEMU virt AArch64 images ## Linux kernel diff --git a/examples/simple/build.zig b/examples/simple/build.zig index 6c3519957..0f5721e86 100644 --- a/examples/simple/build.zig +++ b/examples/simple/build.zig @@ -1,3 +1,6 @@ +// Copyright 2024, UNSW +// SPDX-License-Identifier: BSD-2-Clause + const std = @import("std"); const MicrokitBoard = enum { diff --git a/examples/simple/simple.mk b/examples/simple/simple.mk index 460515862..179a0d16a 100644 --- a/examples/simple/simple.mk +++ b/examples/simple/simple.mk @@ -1,3 +1,8 @@ +# +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause +# QEMU := qemu-system-aarch64 MICROKIT_TOOL ?= $(MICROKIT_SDK)/bin/microkit diff --git a/examples/virtio-snd/README.md b/examples/virtio-snd/README.md index f8876e197..2957f7e3c 100644 --- a/examples/virtio-snd/README.md +++ b/examples/virtio-snd/README.md @@ -1,3 +1,8 @@ + + # virtIO sound example This example shows off the virtIO sound support that libvmm provides using the diff --git a/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/init.dts b/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/init.dts index 8ac7b7e41..4b24816fc 100644 --- a/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/init.dts +++ b/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { memory@0 { reg = <0x00 0x20000000 0x00 0x8000000>; diff --git a/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/io.dts b/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/io.dts index 9417ae20a..f10a6ce54 100644 --- a/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/io.dts +++ b/examples/virtio-snd/board/odroidc4/client_vm/dts/overlays/io.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/init.dts b/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/init.dts index 9dbcbfe9f..cb8865d33 100644 --- a/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/init.dts +++ b/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { memory@0 { reg = <0x00 0x20000000 0x00 0x8000000>; diff --git a/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/io.dts b/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/io.dts index 80062df5f..db3d9068e 100644 --- a/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/io.dts +++ b/examples/virtio-snd/board/odroidc4/snd_driver_vm/dts/overlays/io.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/README.md b/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/README.md index b7499021f..e1ca2d2ba 100644 --- a/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/README.md +++ b/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/README.md @@ -1,3 +1,8 @@ + + # QEMU virt AArch64 images ## Linux kernel diff --git a/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts b/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts index 9cb2390b3..eac5d8e2b 100644 --- a/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts +++ b/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { memory@40000000 { reg = <0x00 0x40000000 0x00 0x8000000>; diff --git a/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/io.dts b/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/io.dts index 9417ae20a..f10a6ce54 100644 --- a/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/io.dts +++ b/examples/virtio-snd/board/qemu_virt_aarch64/client_vm/dts/overlays/io.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/README.md b/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/README.md index b7499021f..e1ca2d2ba 100644 --- a/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/README.md +++ b/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/README.md @@ -1,3 +1,8 @@ + + # QEMU virt AArch64 images ## Linux kernel diff --git a/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/init.dts b/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/init.dts index 103bd357a..b4e352e30 100644 --- a/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/init.dts +++ b/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { memory@40000000 { reg = <0x00 0x40000000 0x00 0x8000000>; diff --git a/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/io.dts b/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/io.dts index 80062df5f..db3d9068e 100644 --- a/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/io.dts +++ b/examples/virtio-snd/board/qemu_virt_aarch64/snd_driver_vm/dts/overlays/io.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio-snd/docs/SOUND.md b/examples/virtio-snd/docs/SOUND.md index 1dca8696f..8f9d9f780 100644 --- a/examples/virtio-snd/docs/SOUND.md +++ b/examples/virtio-snd/docs/SOUND.md @@ -1,3 +1,8 @@ + + Sound in LionsOS ================ *Implementation and design document written by Alex Brown, April 2024.* diff --git a/examples/virtio-snd/include/serial_config.h b/examples/virtio-snd/include/serial_config.h index 02f63d42c..25bf1a802 100644 --- a/examples/virtio-snd/include/serial_config.h +++ b/examples/virtio-snd/include/serial_config.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once #include diff --git a/examples/virtio-snd/shell.nix b/examples/virtio-snd/shell.nix index b78a8d313..cc820e84a 100644 --- a/examples/virtio-snd/shell.nix +++ b/examples/virtio-snd/shell.nix @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + let pkgs = import {}; in diff --git a/examples/virtio-snd/userlevel/control.c b/examples/virtio-snd/userlevel/control.c index 6ed3b03a6..c817f2c6e 100644 --- a/examples/virtio-snd/userlevel/control.c +++ b/examples/virtio-snd/userlevel/control.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/examples/virtio-snd/userlevel/feedback.c b/examples/virtio-snd/userlevel/feedback.c index b727bff82..e1d7e1057 100644 --- a/examples/virtio-snd/userlevel/feedback.c +++ b/examples/virtio-snd/userlevel/feedback.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/examples/virtio-snd/userlevel/pcm.c b/examples/virtio-snd/userlevel/pcm.c index 4084675c7..3d9f17bff 100644 --- a/examples/virtio-snd/userlevel/pcm.c +++ b/examples/virtio-snd/userlevel/pcm.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + /* * This small demo sends a simple sinusoidal wave to your speakers. */ diff --git a/examples/virtio-snd/userlevel/pcm_min.c b/examples/virtio-snd/userlevel/pcm_min.c index e6cf55ef3..df0201b15 100644 --- a/examples/virtio-snd/userlevel/pcm_min.c +++ b/examples/virtio-snd/userlevel/pcm_min.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include diff --git a/examples/virtio-snd/userlevel/record.c b/examples/virtio-snd/userlevel/record.c index 2d2ca2127..f71e7db0d 100644 --- a/examples/virtio-snd/userlevel/record.c +++ b/examples/virtio-snd/userlevel/record.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include diff --git a/examples/virtio/README.md b/examples/virtio/README.md index e7401aefc..295e125b8 100644 --- a/examples/virtio/README.md +++ b/examples/virtio/README.md @@ -1,3 +1,8 @@ + + # Using virtIO with multiple Linux guests This example shows off the virtIO support that libvmm provides using the diff --git a/examples/virtio/board/odroidc4/README.md b/examples/virtio/board/odroidc4/README.md index b7499021f..9fac4f50c 100644 --- a/examples/virtio/board/odroidc4/README.md +++ b/examples/virtio/board/odroidc4/README.md @@ -1,4 +1,9 @@ -# QEMU virt AArch64 images + + +# Odroid-C4 images ## Linux kernel diff --git a/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/disable.dts b/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/disable.dts index 6fcb19620..179dce641 100644 --- a/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/disable.dts +++ b/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/disable.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { secure-monitor { status = "disabled"; diff --git a/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/init.dts b/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/init.dts index 640ca7a1e..c9ee8bc68 100644 --- a/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/init.dts +++ b/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { /delete-node/ memory@0; /delete-node/ chosen; diff --git a/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/io.dts b/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/io.dts index a6e8a2b64..076a0b3be 100644 --- a/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/io.dts +++ b/examples/virtio/board/odroidc4/blk_driver_vm/dts/overlays/io.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio/board/odroidc4/client_vm/dts/overlays/disable.dts b/examples/virtio/board/odroidc4/client_vm/dts/overlays/disable.dts index fb527c941..d03af2adb 100644 --- a/examples/virtio/board/odroidc4/client_vm/dts/overlays/disable.dts +++ b/examples/virtio/board/odroidc4/client_vm/dts/overlays/disable.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { secure-monitor { status = "disabled"; diff --git a/examples/virtio/board/odroidc4/client_vm/dts/overlays/init.dts b/examples/virtio/board/odroidc4/client_vm/dts/overlays/init.dts index 49666644d..e5653dc66 100644 --- a/examples/virtio/board/odroidc4/client_vm/dts/overlays/init.dts +++ b/examples/virtio/board/odroidc4/client_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { /delete-node/ memory@0; /delete-node/ chosen; diff --git a/examples/virtio/board/odroidc4/client_vm/dts/overlays/virtio.dts b/examples/virtio/board/odroidc4/client_vm/dts/overlays/virtio.dts index a22866011..5a6e2b834 100644 --- a/examples/virtio/board/odroidc4/client_vm/dts/overlays/virtio.dts +++ b/examples/virtio/board/odroidc4/client_vm/dts/overlays/virtio.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio/board/qemu_virt_aarch64/README.md b/examples/virtio/board/qemu_virt_aarch64/README.md index b7499021f..e1ca2d2ba 100644 --- a/examples/virtio/board/qemu_virt_aarch64/README.md +++ b/examples/virtio/board/qemu_virt_aarch64/README.md @@ -1,3 +1,8 @@ + + # QEMU virt AArch64 images ## Linux kernel diff --git a/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/disable.dts b/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/disable.dts index a5fbbd9fb..250f66107 100644 --- a/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/disable.dts +++ b/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/disable.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { // enable/disable console serial for debugging /delete-node/ pl011@9000000; diff --git a/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/init.dts b/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/init.dts index 898a07e8d..b5f764f22 100644 --- a/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/init.dts +++ b/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { /delete-node/ memory@40000000; /delete-node/ chosen; diff --git a/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/io.dts b/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/io.dts index 98a821676..8e714257f 100644 --- a/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/io.dts +++ b/examples/virtio/board/qemu_virt_aarch64/blk_driver_vm/dts/overlays/io.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts b/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts index 31cbf9d6d..560901fba 100644 --- a/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts +++ b/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/init.dts @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + / { /delete-node/ memory@40000000; /delete-node/ chosen; diff --git a/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/virtio.dts b/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/virtio.dts index 9b40dfbfd..1774f3b54 100644 --- a/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/virtio.dts +++ b/examples/virtio/board/qemu_virt_aarch64/client_vm/dts/overlays/virtio.dts @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ / { virtio-console@0130000 { compatible = "virtio,mmio"; diff --git a/examples/virtio/include/blk_config.h b/examples/virtio/include/blk_config.h index f8c7acd9c..0c2e5ab32 100644 --- a/examples/virtio/include/blk_config.h +++ b/examples/virtio/include/blk_config.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once #include diff --git a/examples/virtio/include/serial_config.h b/examples/virtio/include/serial_config.h index d3e4b5bb0..6850e0548 100644 --- a/examples/virtio/include/serial_config.h +++ b/examples/virtio/include/serial_config.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once #include diff --git a/examples/virtio/virtio.mk b/examples/virtio/virtio.mk index 759d80342..290d15d2b 100644 --- a/examples/virtio/virtio.mk +++ b/examples/virtio/virtio.mk @@ -1,3 +1,8 @@ +# +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause +# QEMU := qemu-system-aarch64 LIBVMM_TOOLS := $(LIBVMM)/tools diff --git a/examples/zig/README.md b/examples/zig/README.md index 047ec9ee0..e71b44e03 100644 --- a/examples/zig/README.md +++ b/examples/zig/README.md @@ -1,3 +1,8 @@ + + # Zig VMM example This example aims to show using [Zig](https://ziglang.org/) to interact with diff --git a/examples/zig/build.zig b/examples/zig/build.zig index fb2316a0d..739723709 100644 --- a/examples/zig/build.zig +++ b/examples/zig/build.zig @@ -1,3 +1,6 @@ +// Copyright 2024, UNSW +// SPDX-License-Identifier: BSD-2-Clause + const std = @import("std"); const ConfigOptions = enum { diff --git a/examples/zig/build.zig.zon b/examples/zig/build.zig.zon index 41f53c65c..4888b60fe 100644 --- a/examples/zig/build.zig.zon +++ b/examples/zig/build.zig.zon @@ -1,5 +1,5 @@ .{ - .name = "simple", + .name = "zig", .version = "1.0.0", .dependencies = .{ diff --git a/examples/zig/images/README.md b/examples/zig/images/README.md index b7499021f..e1ca2d2ba 100644 --- a/examples/zig/images/README.md +++ b/examples/zig/images/README.md @@ -1,3 +1,8 @@ + + # QEMU virt AArch64 images ## Linux kernel diff --git a/examples/zig/src/libmicrokit.c b/examples/zig/src/libmicrokit.c index 35a033eae..dff1a3917 100644 --- a/examples/zig/src/libmicrokit.c +++ b/examples/zig/src/libmicrokit.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include "libmicrokit.h" void zig_arm_sys_send(seL4_Word sys, seL4_Word dest, seL4_Word info_arg, seL4_Word mr0, seL4_Word mr1, diff --git a/examples/zig/src/libmicrokit.h b/examples/zig/src/libmicrokit.h index c37f6ac4c..02464cec7 100644 --- a/examples/zig/src/libmicrokit.h +++ b/examples/zig/src/libmicrokit.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include void zig_arm_sys_send(seL4_Word sys, seL4_Word dest, seL4_Word info_arg, seL4_Word mr0, seL4_Word mr1, diff --git a/examples/zig/src/libmicrokit.zig b/examples/zig/src/libmicrokit.zig index a17129fa6..2fa356ea2 100644 --- a/examples/zig/src/libmicrokit.zig +++ b/examples/zig/src/libmicrokit.zig @@ -1,3 +1,5 @@ +// Copyright 2024, UNSW +// SPDX-License-Identifier: BSD-2-Clause const libmicrokit = @cImport({ @cInclude("libmicrokit.h"); }); diff --git a/include/libvmm/util/atomic.h b/include/libvmm/util/atomic.h index 523826080..ee7165fc4 100644 --- a/include/libvmm/util/atomic.h +++ b/include/libvmm/util/atomic.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once // Qemu faults if you try load or store with a strict memorder on aarch64. diff --git a/include/libvmm/util/printf.h b/include/libvmm/util/printf.h index 211def252..346813ad9 100644 --- a/include/libvmm/util/printf.h +++ b/include/libvmm/util/printf.h @@ -1,3 +1,7 @@ +/* + * Copyright 2019, Marco Paland + * SPDX-License-Identifier: MIT + */ /////////////////////////////////////////////////////////////////////////////// // \author (c) Marco Paland (info@paland.com) // 2014-2019, PALANDesign Hannover, Germany diff --git a/include/libvmm/util/queue.h b/include/libvmm/util/queue.h index 4a09decb0..a4b4d89b1 100644 --- a/include/libvmm/util/queue.h +++ b/include/libvmm/util/queue.h @@ -1,4 +1,11 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once + #include #include diff --git a/include/libvmm/virq.h b/include/libvmm/virq.h index 8e1df31d6..0b9213642 100644 --- a/include/libvmm/virq.h +++ b/include/libvmm/virq.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/include/libvmm/virtio/sound.h b/include/libvmm/virtio/sound.h index 3695648d8..efa5ef950 100644 --- a/include/libvmm/virtio/sound.h +++ b/include/libvmm/virtio/sound.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, IBM + * + * SPDX-License-Identifier: BSD-3-Clause + */ + /* This header is BSD licensed so anyone can use the definitions to implement * compatible drivers/servers. * diff --git a/include/libvmm/virtio/virtio.h b/include/libvmm/virtio/virtio.h index 7dbb0f203..d9a0f3e95 100644 --- a/include/libvmm/virtio/virtio.h +++ b/include/libvmm/virtio/virtio.h @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once #include diff --git a/shell.nix b/shell.nix index 0cb1bf9b7..500aaff50 100644 --- a/shell.nix +++ b/shell.nix @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + let rust_overlay = import (builtins.fetchTarball "https://github.com/oxalica/rust-overlay/archive/master.tar.gz"); pkgs = import { overlays = [ rust_overlay ]; }; diff --git a/src/arch/aarch64/virq.c b/src/arch/aarch64/virq.c index e16bdb541..8f7459a03 100644 --- a/src/arch/aarch64/virq.c +++ b/src/arch/aarch64/virq.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/src/guest.c b/src/guest.c index 633965db4..a3557d07e 100644 --- a/src/guest.c +++ b/src/guest.c @@ -1,3 +1,8 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ #include #include #include diff --git a/src/util/printf.c b/src/util/printf.c index 37459b372..116d8e940 100644 --- a/src/util/printf.c +++ b/src/util/printf.c @@ -1,3 +1,7 @@ +/* + * Copyright 2019, Marco Paland + * SPDX-License-Identifier: MIT + */ /////////////////////////////////////////////////////////////////////////////// // \author (c) Marco Paland (info@paland.com) // 2014-2019, PALANDesign Hannover, Germany diff --git a/src/virtio/block.c b/src/virtio/block.c index 1c7084431..fc683bdb8 100644 --- a/src/virtio/block.c +++ b/src/virtio/block.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/src/virtio/console.c b/src/virtio/console.c index 8bae5d48b..c21311a9a 100644 --- a/src/virtio/console.c +++ b/src/virtio/console.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/src/virtio/sound.c b/src/virtio/sound.c index bfdc4dee9..a4b1c3985 100644 --- a/src/virtio/sound.c +++ b/src/virtio/sound.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include #include #include diff --git a/tools/dtscat b/tools/dtscat index 9950362d4..54fb729f1 100755 --- a/tools/dtscat +++ b/tools/dtscat @@ -1,4 +1,9 @@ #!/bin/sh + +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + # This is a basic script that concatenates the given Device Tree Sources. # Useful for when you have a single DTS # Author: tim-arney diff --git a/tools/linux/blk/blk_client_init b/tools/linux/blk/blk_client_init index e8377412f..b930ed1c7 100644 --- a/tools/linux/blk/blk_client_init +++ b/tools/linux/blk/blk_client_init @@ -1,3 +1,7 @@ #!/bin/sh +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + mount /dev/vda /mnt \ No newline at end of file diff --git a/tools/linux/blk/board/odroidc4/blk_driver_init b/tools/linux/blk/board/odroidc4/blk_driver_init index 29ff2ae14..91de626c4 100644 --- a/tools/linux/blk/board/odroidc4/blk_driver_init +++ b/tools/linux/blk/board/odroidc4/blk_driver_init @@ -1,3 +1,7 @@ #!/bin/sh +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + /root/uio_blk_driver /dev/mmcblk0 & diff --git a/tools/linux/blk/board/qemu_virt_aarch64/blk_driver_init b/tools/linux/blk/board/qemu_virt_aarch64/blk_driver_init index acd6f89bb..7c6f64743 100644 --- a/tools/linux/blk/board/qemu_virt_aarch64/blk_driver_init +++ b/tools/linux/blk/board/qemu_virt_aarch64/blk_driver_init @@ -1,3 +1,7 @@ #!/bin/sh +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + /root/uio_blk_driver /dev/vda & \ No newline at end of file diff --git a/tools/linux/include/uio/sound.h b/tools/linux/include/uio/sound.h index d5f4a9076..69c693124 100644 --- a/tools/linux/include/uio/sound.h +++ b/tools/linux/include/uio/sound.h @@ -1,4 +1,11 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once + #include #define UIO_SND_FAULT_ADDRESS 0x301000 diff --git a/tools/linux/snd/board/odroidc4/asound.conf b/tools/linux/snd/board/odroidc4/asound.conf index 811b157b6..3b6d54bdf 100644 --- a/tools/linux/snd/board/odroidc4/asound.conf +++ b/tools/linux/snd/board/odroidc4/asound.conf @@ -1,3 +1,7 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + # This assumes the playback device is card 1, and recording is card 0. # S95sound uses 'default' as playback device and 'hw:0,0' as recording. defaults.pcm.card 1 diff --git a/tools/linux/snd/board/qemu_virt_aarch64/asound.conf b/tools/linux/snd/board/qemu_virt_aarch64/asound.conf index 6afd28906..b5a46f0e3 100644 --- a/tools/linux/snd/board/qemu_virt_aarch64/asound.conf +++ b/tools/linux/snd/board/qemu_virt_aarch64/asound.conf @@ -1 +1,5 @@ +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + # Defaults work fine for Qemu, no config necessary diff --git a/tools/linux/snd/snd_driver_init b/tools/linux/snd/snd_driver_init index cfbed27c3..e5dc6e2e8 100644 --- a/tools/linux/snd/snd_driver_init +++ b/tools/linux/snd/snd_driver_init @@ -1,5 +1,9 @@ #!/bin/sh +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + DAEMON="uio_snd_driver" PIDFILE="/var/run/$DAEMON.pid" LOGFILE="/var/log/user_sound" diff --git a/tools/linux/uio_drivers/snd/convert.c b/tools/linux/uio_drivers/snd/convert.c index d6cc63ea8..29bfeee4c 100644 --- a/tools/linux/uio_drivers/snd/convert.c +++ b/tools/linux/uio_drivers/snd/convert.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include "convert.h" #define RATE_COUNT 14 diff --git a/tools/linux/uio_drivers/snd/convert.h b/tools/linux/uio_drivers/snd/convert.h index f4a63c479..c4e079e66 100644 --- a/tools/linux/uio_drivers/snd/convert.h +++ b/tools/linux/uio_drivers/snd/convert.h @@ -1,4 +1,11 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once + #include #include diff --git a/tools/linux/uio_drivers/snd/log.h b/tools/linux/uio_drivers/snd/log.h index 92af21c82..6c7ae7583 100644 --- a/tools/linux/uio_drivers/snd/log.h +++ b/tools/linux/uio_drivers/snd/log.h @@ -1,4 +1,11 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once + #include #define DEBUG_SOUND diff --git a/tools/linux/uio_drivers/snd/main.c b/tools/linux/uio_drivers/snd/main.c index 5488efc84..b6ad63be6 100644 --- a/tools/linux/uio_drivers/snd/main.c +++ b/tools/linux/uio_drivers/snd/main.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include "log.h" #include "stream.h" #include diff --git a/tools/linux/uio_drivers/snd/queue.c b/tools/linux/uio_drivers/snd/queue.c index 700123154..e35618944 100644 --- a/tools/linux/uio_drivers/snd/queue.c +++ b/tools/linux/uio_drivers/snd/queue.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include "queue.h" #include #include diff --git a/tools/linux/uio_drivers/snd/queue.h b/tools/linux/uio_drivers/snd/queue.h index 2d730c3d0..de05bb183 100644 --- a/tools/linux/uio_drivers/snd/queue.h +++ b/tools/linux/uio_drivers/snd/queue.h @@ -1,4 +1,11 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once + #include typedef struct queue queue_t; diff --git a/tools/linux/uio_drivers/snd/stream.c b/tools/linux/uio_drivers/snd/stream.c index f6e66764e..2be099887 100644 --- a/tools/linux/uio_drivers/snd/stream.c +++ b/tools/linux/uio_drivers/snd/stream.c @@ -1,3 +1,9 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #include "stream.h" #include "convert.h" #include "log.h" diff --git a/tools/linux/uio_drivers/snd/stream.h b/tools/linux/uio_drivers/snd/stream.h index 0053345df..69fa3281f 100644 --- a/tools/linux/uio_drivers/snd/stream.h +++ b/tools/linux/uio_drivers/snd/stream.h @@ -1,4 +1,11 @@ +/* + * Copyright 2024, UNSW + * + * SPDX-License-Identifier: BSD-2-Clause + */ + #pragma once + #include #include #include diff --git a/tools/mkvirtdisk b/tools/mkvirtdisk index 02829e8b5..e87b69dd0 100755 --- a/tools/mkvirtdisk +++ b/tools/mkvirtdisk @@ -1,5 +1,9 @@ #!/bin/bash +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + # This bash script creates a virtual disk image with an msdos partition table. # It aligns the partitions to both the sDDF transfer size and the device's logical size. # It creates a FAT filesystem on each partition. diff --git a/tools/packrootfs b/tools/packrootfs index ff9770798..4adbeda44 100755 --- a/tools/packrootfs +++ b/tools/packrootfs @@ -1,5 +1,9 @@ #!/bin/bash +# Copyright 2024, UNSW +# +# SPDX-License-Identifier: BSD-2-Clause + if [ $# -lt 2 ]; then echo "Usage: $0 [-o output_rootfs] [--startup files...] [--home files...] [--etc files...]" exit 1