xref: /third_party/alsa-utils/OAT.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Copyright (c) 2022 Huawei Device Co., Ltd.

    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

    This is the configuration file template for OpenHarmony OSS Audit Tool, please copy it to your project root dir and modify it refer to OpenHarmony/tools_oat/README.

-->
<!-- OAT(OSS Audit Tool) configuration guide:
basedir: Root dir, the basedir + project path is the real source file location.
licensefile: 
1.If the project don't have "LICENSE" in root dir, please define all the license files in this project in , OAT will check license files according to this rule.

tasklist(only for batch mode):
1. task: Define oat check thread, each task will start a new thread.
2. task name: Only an name, no practical effect.
3. task policy: Default policy for projects under this task, this field is required and the specified policy must defined in policylist.
4. task filter: Default filefilter for projects under this task, this field is required and the specified filefilter must defined in filefilterlist.
5. task project: Projects to be checked, the path field define the source root dir of the project.


policyList:
1. policy: All policyitems will be merged to default OAT.xml rules, the name of policy doesn't affect OAT check process.
2. policyitem: The fields type, name, path, desc is required, and the fields rule, group, filefilter is optional,the default value is:
<policyitem type="" name="" path="" desc="" rule="may" group="defaultGroup" filefilter="defaultPolicyFilter"/>
3. policyitem type:
    "compatibility" is used to check license compatibility in the specified path; 
    "license" is used to check source license header in the specified path;
    "copyright" is used to check source copyright header in the specified path;
    "import" is used to check source dependency in the specified path, such as import ... ,include ...
    "filetype" is used to check file type in the specified path, supported file types: archive, binary
    "filename" is used to check whether the specified file exists in the specified path(support projectroot in default OAT.xml), supported file names: LICENSE, README, README.OpenSource

4. policyitem name: This field is used for define the license, copyright, "*" means match all, the "!" prefix means could not match this value. For example, "!GPL" means can not use GPL license. 
5. policyitem path: This field is used for define the source file scope to apply this policyitem, the "!" prefix means exclude the files. For example, "!.*/lib/.*" means files in lib dir will be exclude while process this policyitem.
6. policyitem rule and group: These two fields are used together to merge policy results. "may" policyitems in the same group means any one in this group passed, the result will be passed.
7. policyitem filefilter: Used to bind filefilter which define filter rules.
8. filefilter: Filter rules, the type filename is used to filter file name, the type filepath is used to filter file path.

Note:If the text contains special characters, please escape them according to the following rules:
" == &gt;
& == &gt;
' == &gt;
< == &gt;
> == &gt;
-->
<configuration>
    <oatconfig>
        <licensefile>COPYING</licensefile>
        <policylist>
            <policy name="projectPolicy" desc="">
                <policyitem type="license" name="GPL" path=".*" desc="license"/>
                <policyitem type="copyright" name="*" path=".*" rule="may" group="defaultGroup" filefilter="copyrightPolicyFilter" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
            </policy>
        </policylist>
        <filefilterlist>
            <filefilter name="defaultFilter" desc="Files not to check">
                <filteritem type="filename" name="*.am|*.po|*.1|*.m4|*.ac|*.sh|README.*|*.csv" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filename" name="*.rst|*Skylake|*.Broadwell|*.Haswell" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filename" name="TODO|INSTALL|go|LINGUAS|help|buildrpm|00main" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filename" name="ca0106|ChangeLog|gitcompile|Makevars|hda" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filename" name="map_test_case|default|test|info" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/.*.h" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/volume_mapping.c" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/configparser.c" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/curskey.c" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/menu_widget.c" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/mixer_clickable.c" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsamixer/bindings.c" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="include/gettext.h" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="speaker-test/*.*" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="include/gettext_curses.h" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsactl/alsactl.h" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="aplay/formats.h" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsactl/alsactl_init.xml" desc="三方开源，不需检测文件头是否遗漏版权声明"/>
                <filteritem type="filepath" name="alsactl/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsactl/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsamixer/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsaucm/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsaucm/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="axfer/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="axfer/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="bat/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="bat/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="include/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="topology/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="topology/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="amidi/amidi.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="amixer/amixer.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="amixer/amixer.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="seq/*/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsaconf/.*.8" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="topology/.*.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="topology/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsaloop/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsaloop/alsaloop.h" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="iecset/.*.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="aplay/aplay.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="nhlt/nhlt-dmic-info.c" desc="三方开源，不需检测license、copyright"/>
                <filteritem type="filepath" name="alsamixer/alsamixer.rc.example" desc="三方开源，不需检测license、copyright"/>
            </filefilter>
            <filefilter name="defaultPolicyFilter" desc="Filters for compatibility, license header policies">
            </filefilter>
	        <filefilter name="copyrightPolicyFilter" desc="Filters for copyright header policies">
            </filefilter>
            <filefilter name="licenseFileNamePolicyFilter" desc="Filters for LICENSE file policies">
            </filefilter>
            <filefilter name="readmeFileNamePolicyFilter" desc="Filters for README file policies">
            </filefilter>
            <filefilter name="readmeOpenSourcefileNamePolicyFilter" desc="Filters for README.OpenSource file policies">
            </filefilter>
            <filefilter name="binaryFileTypePolicyFilter" desc="Filters for binary file policies">
            <filteritem type="filepath" name="speaker-test/samples/.*.wav" desc="binary files"/>
            </filefilter>
        </filefilterlist>
    </oatconfig>
</configuration>