123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212 |
- #!/usr/bin/env perl
- # SPDX-License-Identifier: GPL-2.0-only
- # Copyright 2016 by Frank Rowand
- # Copyright 2016 by Gaurav Minocha
- #
- use strict 'refs';
- use strict subs;
- use Getopt::Long;
- $VUFX = "160610a";
- $script_name = $0;
- $script_name =~ s|^.*/||;
- # ----- constants for print_flags()
- # Position in string $pr_flags. Range of 0..($num_pr_flags - 1).
- $pr_flag_pos_mcompatible = 0;
- $pr_flag_pos_driver = 1;
- $pr_flag_pos_mdriver = 2;
- $pr_flag_pos_config = 3;
- $pr_flag_pos_mconfig = 4;
- $pr_flag_pos_node_not_enabled = 5;
- $pr_flag_pos_white_list = 6;
- $pr_flag_pos_hard_coded = 7;
- $pr_flag_pos_config_hard_coded = 8;
- $pr_flag_pos_config_none = 9;
- $pr_flag_pos_config_m = 10;
- $pr_flag_pos_config_y = 11;
- $pr_flag_pos_config_test_fail = 12;
- $num_pr_flags = $pr_flag_pos_config_test_fail + 1;
- # flags in @pr_flag_value must be unique values to allow simple regular
- # expessions to work for --include_flags and --exclude_flags.
- # Convention: use upper case letters for potential issues or problems.
- @pr_flag_value = ('M', 'd', 'D', 'c', 'C', 'E', 'W', 'H', 'x', 'n', 'm', 'y', 'F');
- @pr_flag_help = (
- "multiple compatibles found for this node",
- "driver found for this compatible",
- "multiple drivers found for this compatible",
- "kernel config found for this driver",
- "multiple config options found for this driver",
- "node is not enabled",
- "compatible is white listed",
- "matching driver and/or kernel config is hard coded",
- "kernel config hard coded in Makefile",
- "one or more kernel config file options is not set",
- "one or more kernel config file options is set to 'm'",
- "one or more kernel config file options is set to 'y'",
- "one of more kernel config file options fails to have correct value"
- );
- # -----
- %driver_config = (); # driver config array, indexed by driver source file
- %driver_count = (); # driver_cnt, indexed by compatible
- %compat_driver = (); # compatible driver array, indexed by compatible
- %existing_config = (); # existing config symbols present in given config file
- # expected values are: "y", "m", a decimal number, a
- # hex number, or a string
- # ----- magic compatibles, do not have a driver
- #
- # Will not search for drivers for these compatibles.
- %compat_white_list = (
- 'none' => '1',
- 'pci' => '1',
- 'simple-bus' => '1',
- );
- # Will not search for drivers for these compatibles.
- #
- # These compatibles have a very large number of false positives.
- #
- # 'hardcoded_no_driver' is a magic value. Other code knows this
- # magic value. Do not use 'no_driver' here!
- #
- # Revisit each 'hardcoded_no_driver' to see how the compatible
- # is used. Are there drivers that can be provided?
- %driver_hard_code_list = (
- 'cache' => ['hardcoded_no_driver'],
- 'eeprom' => ['hardcoded_no_driver'],
- 'gpio' => ['hardcoded_no_driver'],
- 'gpio-keys' => ['drivers/input/keyboard/gpio_keys.c'],
- 'i2c-gpio' => ['drivers/i2c/busses/i2c-gpio.c'],
- 'isa' => ['arch/mips/mti-malta/malta-dt.c',
- 'arch/x86/kernel/devicetree.c'],
- 'led' => ['hardcoded_no_driver'],
- 'm25p32' => ['hardcoded_no_driver'],
- 'm25p64' => ['hardcoded_no_driver'],
- 'm25p80' => ['hardcoded_no_driver'],
- 'mtd-ram' => ['drivers/mtd/maps/physmap_of.c'],
- 'pwm-backlight' => ['drivers/video/backlight/pwm_bl.c'],
- 'spidev' => ['hardcoded_no_driver'],
- 'syscon' => ['drivers/mfd/syscon.c'],
- 'tlv320aic23' => ['hardcoded_no_driver'],
- 'wm8731' => ['hardcoded_no_driver'],
- );
- # Use these config options instead of searching makefiles
- %driver_config_hard_code_list = (
- # this one needed even if %driver_hard_code_list is empty
- 'no_driver' => ['no_config'],
- 'hardcoded_no_driver' => ['no_config'],
- # drivers/usb/host/ehci-ppc-of.c
- # drivers/usb/host/ehci-xilinx-of.c
- # are included from:
- # drivers/usb/host/ehci-hcd.c
- # thus the search of Makefile for the included .c files is incorrect
- # ehci-hcd.c wraps the includes with ifdef CONFIG_USB_EHCI_HCD_..._OF
- #
- # similar model for ohci-hcd.c (but no ohci-xilinx-of.c)
- #
- # similarly, uhci-hcd.c includes uhci-platform.c
- 'drivers/usb/host/ehci-ppc-of.c' => ['CONFIG_USB_EHCI_HCD',
- 'CONFIG_USB_EHCI_HCD_PPC_OF'],
- 'drivers/usb/host/ohci-ppc-of.c' => ['CONFIG_USB_OHCI_HCD',
- 'CONFIG_USB_OHCI_HCD_PPC_OF'],
- 'drivers/usb/host/ehci-xilinx-of.c' => ['CONFIG_USB_EHCI_HCD',
- 'CONFIG_USB_EHCI_HCD_XILINX'],
- 'drivers/usb/host/uhci-platform.c' => ['CONFIG_USB_UHCI_HCD',
- 'CONFIG_USB_UHCI_PLATFORM'],
- # scan_makefile will find only one of these config options:
- # ifneq ($(CONFIG_SOC_IMX6)$(CONFIG_SOC_LS1021A),)
- 'arch/arm/mach-imx/platsmp.c' => ['CONFIG_SOC_IMX6 && CONFIG_SMP',
- 'CONFIG_SOC_LS1021A && CONFIG_SMP'],
- );
- # 'virt/kvm/arm/.*' are controlled by makefiles in other directories,
- # using relative paths, such as 'KVM := ../../../virt/kvm'. Do not
- # add complexity to find_kconfig() to deal with this. There is a long
- # term intent to change the kvm related makefiles to the normal kernel
- # style. After that is done, this entry can be removed from the
- # black_list_driver.
- @black_list_driver = (
- # kvm no longer a problem after commit 503a62862e8f in 4.7-rc1
- # 'virt/kvm/arm/.*',
- );
- sub usage()
- {
- print
- "
- Usage: $script_name [options] device-tree...
- device_tree is: dts_file | dtb_file | proc_device-tree
- Valid options:
- -c FILE Read kernel config options from FILE
- --config FILE synonym for 'c'
- --config-format config file friendly output format
- --exclude-flag FLAG exclude entries with a matching flag
- -h Display this message and exit
- --help synonym for 'h'
- --black-list-driver use driver black list
- --white-list-config use config white list
- --white-list-driver use driver white list
- --include-flag FLAG include only entries with a matching flag
- --include-suspect include only entries with an uppercase flag
- --short-name do not show the path portion of the node name
- --show-lists report of white and black lists
- --version Display program version and exit
- Report driver source files that match the compatibles in the device
- tree file and the kernel config options that enable the driver source
- files.
- This program must be run in the root directory of a Linux kernel
- source tree.
- The default format is a report that is intended to be easily human
- scannable.
- An alternate format can be selected by --config-format. This will
- create output that can easily be edited to create a fragment that can
- be appended to the existing kernel config file. Each entry consists of
- multiple lines. The first line reports flags, the node path, compatible
- value, driver file matching the compatible, configuration options, and
- current values of the configuration options. For each configuration
- option, the following lines report the current value and the value that
- is required for the driver file to be included in the kernel.
- If a large number of drivers or config options is listed for a node,
- and the '$pr_flag_value[$pr_flag_pos_hard_coded]' flag is set consider using --white-list-config and/or
- --white-list-driver. If the white list option suppresses the correct
- entry please report that as a bug.
- CAUTION:
- This program uses heuristics to guess which driver(s) support each
- compatible string and which config option(s) enables the driver(s).
- Do not believe that the reported information is fully correct.
- This program is intended to aid the process of determining the
- proper kernel configuration for a device tree, but this is not
- a fully automated process -- human involvement may still be
- required!
- The driver match heuristic used is to search for source files
- containing the compatible string enclosed in quotes.
- This program might not be able to find all drivers matching a
- compatible string.
- Some makefiles are overly clever. This program was not made
- complex enough to handle them. If no config option is listed
- for a driver, look at the makefile for the driver source file.
- Even if a config option is listed for a driver, some other
- available config options may not be listed.
- FLAG values:
- ";
- for ($k = 0; $k < $num_pr_flags; $k++) {
- printf " %s %s\n", $pr_flag_value[$k], $pr_flag_help[$k];
- }
- print
- "
- Upper case letters indicate potential issues or problems.
- The flag:
- ";
- $k = $pr_flag_pos_hard_coded;
- printf " %s %s\n", $pr_flag_value[$k], $pr_flag_help[$k];
- print
- "
- will be set if the config or driver is in the white lists, even if
- --white-list-config and --white-list-driver are not specified.
- This is a hint that 1) many of these reported lines are likely to
- be incorrect, and 2) using those options will reduce the number of
- drivers and/or config options reported.
- --white-list-config and --white-list-driver may not be accurate if this
- program is not well maintained. Use them with appropriate skepticism.
- Use the --show-lists option to report the values in the list.
- Return value:
- 0 if no error
- 1 error processing command line
- 2 unable to open or read kernel config file
- 3 unable to open or process input device tree file(s)
- EXAMPLES:
- dt_to_config arch/arm/boot/dts/my_dts_file.dts
- Basic report.
- dt_to_config \\
- --config \${KBUILD_OUTPUT}/.config \\
- arch/\${ARCH}/boot/dts/my_dts_file.dts
- Full report, with config file issues noted.
- dt_to_config --include-suspect \\
- --config \${KBUILD_OUTPUT}/.config \\
- arch/\${ARCH}/boot/dts/my_dts_file.dts
- Report of node / compatible string / driver tuples that should
- be further investigated. A node may have multiple compatible
- strings. A compatible string may be matched by multiple drivers.
- A driver may have config file issues noted. The compatible string
- and/or driver may be in the white lists.
- dt_to_config --include-suspect --config-format \\
- --config ${KBUILD_OUTPUT}/.config \\
- arch/\${ARCH}/boot/dts/my_dts_file.dts
- Report of node / compatible string / driver tuples that should
- be further investigated. The report can be edited to uncomment
- the config options to select the desired tuple for a given node.
- A node may have multiple compatible strings. A compatible string
- may be matched by multiple drivers. A driver may have config file
- issues noted. The compatible string and/or driver may be in the
- white lists.
- ";
- }
- sub set_flag()
- {
- # pr_flags_ref is a reference to $pr_flags
- my $pr_flags_ref = shift;
- my $pos = shift;
- substr $$pr_flags_ref, $pos, 1, $pr_flag_value[$pos];
- return $pr_flags;
- }
- sub print_flags()
- {
- # return 1 if anything printed, else 0
- # some fields of pn_arg_ref might not be used in this function, but
- # extract all of them anyway.
- my $pn_arg_ref = shift;
- my $compat = $pn_arg_ref->{compat};
- my $compatible_cnt = $pn_arg_ref->{compatible_cnt};
- my $config = $pn_arg_ref->{config};
- my $config_cnt = $pn_arg_ref->{config_cnt};
- my $driver = $pn_arg_ref->{driver};
- my $driver_cnt = $pn_arg_ref->{driver_cnt};
- my $full_node = $pn_arg_ref->{full_node};
- my $node = $pn_arg_ref->{node};
- my $node_enabled = $pn_arg_ref->{node_enabled};
- my $white_list = $pn_arg_ref->{white_list};
- my $pr_flags = '-' x $num_pr_flags;
- # ----- set flags in $pr_flags
- if ($compatible_cnt > 1) {
- &set_flag(\$pr_flags, $pr_flag_pos_mcompatible);
- }
- if ($config_cnt > 1) {
- &set_flag(\$pr_flags, $pr_flag_pos_mconfig);
- }
- if ($driver_cnt >= 1) {
- &set_flag(\$pr_flags, $pr_flag_pos_driver);
- }
- if ($driver_cnt > 1) {
- &set_flag(\$pr_flags, $pr_flag_pos_mdriver);
- }
- # These strings are the same way the linux kernel tests.
- # The ePapr lists of values is slightly different.
- if (!(
- ($node_enabled eq "") ||
- ($node_enabled eq "ok") ||
- ($node_enabled eq "okay")
- )) {
- &set_flag(\$pr_flags, $pr_flag_pos_node_not_enabled);
- }
- if ($white_list) {
- &set_flag(\$pr_flags, $pr_flag_pos_white_list);
- }
- if (exists($driver_hard_code_list{$compat}) ||
- (exists($driver_config_hard_code_list{$driver}) &&
- ($driver ne "no_driver"))) {
- &set_flag(\$pr_flags, $pr_flag_pos_hard_coded);
- }
- my @configs = split(' && ', $config);
- for $configs (@configs) {
- $not = $configs =~ /^!/;
- $configs =~ s/^!//;
- if (($configs ne "no_config") && ($configs ne "no_makefile")) {
- &set_flag(\$pr_flags, $pr_flag_pos_config);
- }
- if (($config_cnt >= 1) &&
- ($configs !~ /CONFIG_/) &&
- (($configs ne "no_config") && ($configs ne "no_makefile"))) {
- &set_flag(\$pr_flags, $pr_flag_pos_config_hard_coded);
- }
- my $existing_config = $existing_config{$configs};
- if ($existing_config eq "m") {
- &set_flag(\$pr_flags, $pr_flag_pos_config_m);
- # Possible fail, depends on whether built in or
- # module is desired.
- &set_flag(\$pr_flags, $pr_flag_pos_config_test_fail);
- } elsif ($existing_config eq "y") {
- &set_flag(\$pr_flags, $pr_flag_pos_config_y);
- if ($not) {
- &set_flag(\$pr_flags, $pr_flag_pos_config_test_fail);
- }
- } elsif (($config_file) && ($configs =~ /CONFIG_/)) {
- &set_flag(\$pr_flags, $pr_flag_pos_config_none);
- if (!$not) {
- &set_flag(\$pr_flags, $pr_flag_pos_config_test_fail);
- }
- }
- }
- # ----- include / exclude filters
- if ($include_flag_pattern && ($pr_flags !~ m/$include_flag_pattern/)) {
- return 0;
- }
- if ($exclude_flag_pattern && ($pr_flags =~ m/$exclude_flag_pattern/)) {
- return 0;
- }
- if ($config_format) {
- print "# ";
- }
- print "$pr_flags : ";
- return 1;
- }
- sub print_node()
- {
- # return number of lines printed
- # some fields of pn_arg_ref might not be used in this function, but
- # extract all of them anyway.
- my $pn_arg_ref = shift;
- my $compat = $pn_arg_ref->{compat};
- my $compatible_cnt = $pn_arg_ref->{compatible_cnt};
- my $config = $pn_arg_ref->{config};
- my $config_cnt = $pn_arg_ref->{config_cnt};
- my $driver = $pn_arg_ref->{driver};
- my $driver_cnt = $pn_arg_ref->{driver_cnt};
- my $full_node = $pn_arg_ref->{full_node};
- my $node = $pn_arg_ref->{node};
- my $node_enabled = $pn_arg_ref->{node_enabled};
- my $white_list = $pn_arg_ref->{white_list};
- my $separator;
- if (! &print_flags($pn_arg_ref)) {
- return 0;
- }
- if ($short_name) {
- print "$node";
- } else {
- print "$full_node";
- }
- print " : $compat : $driver : $config : ";
- my @configs = split(' && ', $config);
- if ($config_file) {
- for $configs (@configs) {
- $configs =~ s/^!//;
- my $existing_config = $existing_config{$configs};
- if (!$existing_config) {
- # check for /-m/, /-y/, or /-objs/
- if ($configs !~ /CONFIG_/) {
- $existing_config = "x";
- };
- };
- if ($existing_config) {
- print "$separator", "$existing_config";
- $separator = ", ";
- } else {
- print "$separator", "n";
- $separator = ", ";
- }
- }
- } else {
- print "none";
- }
- print "\n";
- if ($config_format) {
- for $configs (@configs) {
- $not = $configs =~ /^!/;
- $configs =~ s/^!//;
- my $existing_config = $existing_config{$configs};
- if ($not) {
- if ($configs !~ /CONFIG_/) {
- print "# $configs\n";
- } elsif ($existing_config eq "m") {
- print "# $configs is m\n";
- print "# $configs=n\n";
- } elsif ($existing_config eq "y") {
- print "# $configs is set\n";
- print "# $configs=n\n";
- } else {
- print "# $configs is not set\n";
- print "# $configs=n\n";
- }
- } else {
- if ($configs !~ /CONFIG_/) {
- print "# $configs\n";
- } elsif ($existing_config eq "m") {
- print "# $configs is m\n";
- print "# $configs=y\n";
- } elsif ($existing_config eq "y") {
- print "# $configs is set\n";
- print "# $configs=y\n";
- } else {
- print "# $configs is not set\n";
- print "# $configs=y\n";
- }
- }
- }
- }
- return 1;
- }
- sub scan_makefile
- {
- my $pn_arg_ref = shift;
- my $driver = shift;
- # ----- Find Kconfig symbols that enable driver
- my ($dir, $base) = $driver =~ m{(.*)/(.*).c};
- my $makefile = $dir . "/Makefile";
- if (! -r $makefile) {
- $makefile = $dir . "/Kbuild";
- }
- if (! -r $makefile) {
- my $config;
- $config = 'no_makefile';
- push @{ $driver_config{$driver} }, $config;
- return;
- }
- if (!open(MAKEFILE_FILE, "<", "$makefile")) {
- return;
- }
- my $line;
- my @config;
- my @if_config;
- my @make_var;
- NEXT_LINE:
- while ($next_line = <MAKEFILE_FILE>) {
- my $config;
- my $if_config;
- my $ifdef;
- my $ifeq;
- my $ifndef;
- my $ifneq;
- my $ifdef_config;
- my $ifeq_config;
- my $ifndef_config;
- my $ifneq_config;
- chomp($next_line);
- $line = $line . $next_line;
- if ($next_line =~ /\\$/) {
- $line =~ s/\\$/ /;
- next NEXT_LINE;
- }
- if ($line =~ /^\s*#/) {
- $line = "";
- next NEXT_LINE;
- }
- # ----- condition ... else ... endif
- if ($line =~ /^([ ]\s*|)else\b/) {
- $if_config = "!" . pop @if_config;
- $if_config =~ s/^!!//;
- push @if_config, $if_config;
- $line =~ s/^([ ]\s*|)else\b//;
- }
- ($null, $ifeq_config, $ifeq_config_val ) = $line =~ /^([ ]\s*|)ifeq\b.*\b(CONFIG_[A-Za-z0-9_]*)(.*)/;
- ($null, $ifneq_config, $ifneq_config_val) = $line =~ /^([ ]\s*|)ifneq\b.*\b(CONFIG_[A-Za-z0-9_]*)(.*)/;
- ($null, $ifdef_config) = $line =~ /^([ ]\s*|)ifdef\b.*\b(CONFIG_[A-Za-z0-9_]*)/;
- ($null, $ifndef_config) = $line =~ /^([ ]\s*|)ifndef\b.*\b(CONFIG_[A-Za-z0-9_]*)/;
- ($null, $ifeq) = $line =~ /^([ ]\s*|)ifeq\b\s*(.*)/;
- ($null, $ifneq) = $line =~ /^([ ]\s*|)ifneq\b\s*(.*)/;
- ($null, $ifdef) = $line =~ /^([ ]\s*|)ifdef\b\s*(.*)/;
- ($null, $ifndef) = $line =~ /^([ ]\s*|)ifndef\b\s*(.*)/;
- # Order of tests is important. Prefer "CONFIG_*" regex match over
- # less specific regex match.
- if ($ifdef_config) {
- $if_config = $ifdef_config;
- } elsif ($ifeq_config) {
- if ($ifeq_config_val =~ /y/) {
- $if_config = $ifeq_config;
- } else {
- $if_config = "!" . $ifeq_config;
- }
- } elsif ($ifndef_config) {
- $if_config = "!" . $ifndef_config;
- } elsif ($ifneq_config) {
- if ($ifneq_config_val =~ /y/) {
- $if_config = "!" . $ifneq_config;
- } else {
- $if_config = $ifneq_config;
- }
- } elsif ($ifdef) {
- $if_config = $ifdef;
- } elsif ($ifeq) {
- $if_config = $ifeq;
- } elsif ($ifndef) {
- $if_config = "!" . $ifndef;
- } elsif ($ifneq) {
- $if_config = "!" . $ifneq;
- } else {
- $if_config = "";
- }
- $if_config =~ s/^!!//;
- if ($if_config) {
- push @if_config, $if_config;
- $line = "";
- next NEXT_LINE;
- }
- if ($line =~ /^([ ]\s*|)endif\b/) {
- pop @if_config;
- $line = "";
- next NEXT_LINE;
- }
- # ----- simple CONFIG_* = *.[co] or xxx [+:?]*= *.[co]
- # Most makefiles select on *.o, but
- # arch/powerpc/boot/Makefile selects on *.c
- ($config) = $line =~ /(CONFIG_[A-Za-z0-9_]+).*\b$base.[co]\b/;
- # ----- match a make variable instead of *.[co]
- # Recursively expanded variables are not handled.
- if (!$config) {
- my $make_var;
- ($make_var) = $line =~ /\s*(\S+?)\s*[+:\?]*=.*\b$base.[co]\b/;
- if ($make_var) {
- if ($make_var =~ /[a-zA-Z0-9]+-[ym]/) {
- $config = $make_var;
- } elsif ($make_var =~ /[a-zA-Z0-9]+-objs/) {
- $config = $make_var;
- } else {
- push @make_var, $make_var;
- }
- }
- }
- if (!$config) {
- for $make_var (@make_var) {
- ($config) = $line =~ /(CONFIG_[A-Za-z0-9_]+).*\b$make_var\b/;
- last if ($config);
- }
- }
- if (!$config) {
- for $make_var (@make_var) {
- ($config) = $line =~ /\s*(\S+?)\s*[+:\?]*=.*\b$make_var\b/;
- last if ($config);
- }
- }
- # ----- next if no config found
- if (!$config) {
- $line = "";
- next NEXT_LINE;
- }
- for $if_config (@if_config) {
- $config = $if_config . " && " . $config;
- }
- push @{ $driver_config{$driver} }, $config;
- $line = "";
- }
- close(MAKEFILE_FILE);
- }
- sub find_kconfig
- {
- my $pn_arg_ref = shift;
- my $driver = shift;
- my $lines_printed = 0;
- my @configs;
- if (!@{ $driver_config{$driver} }) {
- &scan_makefile($pn_arg_ref, $driver);
- if (!@{ $driver_config{$driver} }) {
- push @{ $driver_config{$driver} }, "no_config";
- }
- }
- @configs = @{ $driver_config{$driver} };
- $$pn_arg_ref{config_cnt} = $#configs + 1;
- for my $config (@configs) {
- $$pn_arg_ref{config} = $config;
- $lines_printed += &print_node($pn_arg_ref);
- }
- return $lines_printed;
- }
- sub handle_compatible()
- {
- my $full_node = shift;
- my $node = shift;
- my $compatible = shift;
- my $node_enabled = shift;
- my $compat;
- my $lines_printed = 0;
- my %pn_arg = ();
- return if (!$node or !$compatible);
- # Do not process compatible property of root node,
- # it is used to match board, not to bind a driver.
- return if ($node eq "/");
- $pn_arg{full_node} = $full_node;
- $pn_arg{node} = $node;
- $pn_arg{node_enabled} = $node_enabled;
- my @compatibles = split('", "', $compatible);
- $compatibles[0] =~ s/^"//;
- $compatibles[$#compatibles] =~ s/"$//;
- $pn_arg{compatible_cnt} = $#compatibles + 1;
- COMPAT:
- for $compat (@compatibles) {
- $pn_arg{compat} = $compat;
- $pn_arg{driver_cnt} = 0;
- $pn_arg{white_list} = 0;
- if (exists($compat_white_list{$compat})) {
- $pn_arg{white_list} = 1;
- $pn_arg{driver} = "no_driver";
- $pn_arg{config_cnt} = 1;
- $pn_arg{config} = "no_config";
- $lines_printed += &print_node(\%pn_arg);
- next COMPAT;
- }
- # ----- if compat previously seen, use cached info
- if (exists($compat_driver{$compat})) {
- for my $driver (@{ $compat_driver{$compat} }) {
- $pn_arg{driver} = $driver;
- $pn_arg{driver_cnt} = $driver_count{$compat};
- $pn_arg{config_cnt} = $#{ $driver_config{$driver}} + 1;
- for my $config (@{ $driver_config{$driver} }) {
- $pn_arg{config} = $config;
- $lines_printed += &print_node(\%pn_arg);
- }
- if (!@{ $driver_config{$driver} }) {
- # no config cached yet
- # $driver in %driver_hard_code_list
- # but not %driver_config_hard_code_list
- $lines_printed += &find_kconfig(\%pn_arg, $driver);
- }
- }
- next COMPAT;
- }
- # ----- Find drivers (source files that contain compatible)
- # this will miss arch/sparc/include/asm/parport.h
- # It is better to move the compatible out of the .h
- # than to add *.h. to the files list, because *.h generates
- # a lot of false negatives.
- my $files = '"*.c"';
- my $drivers = `git grep -l '"$compat"' -- $files`;
- chomp($drivers);
- if ($drivers eq "") {
- $pn_arg{driver} = "no_driver";
- $pn_arg{config_cnt} = 1;
- $pn_arg{config} = "no_config";
- push @{ $compat_driver{$compat} }, "no_driver";
- $lines_printed += &print_node(\%pn_arg);
- next COMPAT;
- }
- my @drivers = split("\n", $drivers);
- $driver_count{$compat} = $#drivers + 1;
- $pn_arg{driver_cnt} = $#drivers + 1;
- DRIVER:
- for my $driver (@drivers) {
- push @{ $compat_driver{$compat} }, $driver;
- $pn_arg{driver} = $driver;
- # ----- if driver previously seen, use cached info
- $pn_arg{config_cnt} = $#{ $driver_config{$driver} } + 1;
- for my $config (@{ $driver_config{$driver} }) {
- $pn_arg{config} = $config;
- $lines_printed += &print_node(\%pn_arg);
- }
- if (@{ $driver_config{$driver} }) {
- next DRIVER;
- }
- if ($black_list_driver) {
- for $black (@black_list_driver) {
- next DRIVER if ($driver =~ /^$black$/);
- }
- }
- # ----- Find Kconfig symbols that enable driver
- $lines_printed += &find_kconfig(\%pn_arg, $driver);
- }
- }
- # White space (line) between nodes for readability.
- # Each node may report several compatibles.
- # For each compatible, multiple drivers may be reported.
- # For each driver, multiple CONFIG_ options may be reported.
- if ($lines_printed) {
- print "\n";
- }
- }
- sub read_dts()
- {
- my $file = shift;
- my $compatible = "";
- my $line;
- my $node = "";
- my $node_enabled = "";
- if (! -r $file) {
- print STDERR "file '$file' is not readable or does not exist\n";
- exit 3;
- }
- if (!open(DT_FILE, "-|", "$dtx_diff $file")) {
- print STDERR "\n";
- print STDERR "shell command failed:\n";
- print STDERR " $dtx_diff $file\n";
- print STDERR "\n";
- exit 3;
- }
- FILE:
- while ($line = <DT_FILE>) {
- chomp($line);
- if ($line =~ /{/) {
- &handle_compatible($full_node, $node, $compatible,
- $node_enabled);
- while ($end_node_count-- > 0) {
- pop @full_node;
- };
- $end_node_count = 0;
- $full_node = @full_node[-1];
- $node = $line;
- $node =~ s/^\s*(.*)\s+\{.*/$1/;
- $node =~ s/.*: //;
- if ($node eq '/' ) {
- $full_node = '/';
- } elsif ($full_node ne '/') {
- $full_node = $full_node . '/' . $node;
- } else {
- $full_node = '/' . $node;
- }
- push @full_node, $full_node;
- $compatible = "";
- $node_enabled = "";
- next FILE;
- }
- if ($line =~ /}/) {
- $end_node_count++;
- }
- if ($line =~ /(\s+|^)status =/) {
- $node_enabled = $line;
- $node_enabled =~ s/^\t*//;
- $node_enabled =~ s/^status = "//;
- $node_enabled =~ s/";$//;
- next FILE;
- }
- if ($line =~ /(\s+|^)compatible =/) {
- # Extract all compatible entries for this device
- # White space matching here and in handle_compatible() is
- # precise, because input format is the output of dtc,
- # which is invoked by dtx_diff.
- $compatible = $line;
- $compatible =~ s/^\t*//;
- $compatible =~ s/^compatible = //;
- $compatible =~ s/;$//;
- }
- }
- &handle_compatible($full_node, $node, $compatible, $node_enabled);
- close(DT_FILE);
- }
- sub read_config_file()
- {
- if (! -r $config_file) {
- print STDERR "file '$config_file' is not readable or does not exist\n";
- exit 2;
- }
- if (!open(CONFIG_FILE, "<", "$config_file")) {
- print STDERR "open $config_file failed\n";
- exit 2;
- }
- my @line;
- LINE:
- while ($line = <CONFIG_FILE>) {
- chomp($line);
- next LINE if ($line =~ /^\s*#/);
- next LINE if ($line =~ /^\s*$/);
- @line = split /=/, $line;
- $existing_config{@line[0]} = @line[1];
- }
- close(CONFIG_FILE);
- }
- sub cmd_line_err()
- {
- my $msg = shift;
- print STDERR "\n";
- print STDERR " ERROR processing command line options\n";
- print STDERR " $msg\n" if ($msg ne "");
- print STDERR "\n";
- print STDERR " For help, type '$script_name --help'\n";
- print STDERR "\n";
- }
- # -----------------------------------------------------------------------------
- # program entry point
- Getopt::Long::Configure("no_ignore_case", "bundling");
- if (!GetOptions(
- "c=s" => \$config_file,
- "config=s" => \$config_file,
- "config-format" => \$config_format,
- "exclude-flag=s" => \@exclude_flag,
- "h" => \$help,
- "help" => \$help,
- "black-list-driver" => \$black_list_driver,
- "white-list-config" => \$white_list_config,
- "white-list-driver" => \$white_list_driver,
- "include-flag=s" => \@include_flag,
- "include-suspect" => \$include_suspect,
- "short-name" => \$short_name,
- "show-lists" => \$show_lists,
- "version" => \$version,
- )) {
- &cmd_line_err();
- exit 1;
- }
- my $exit_after_messages = 0;
- if ($version) {
- print STDERR "\n$script_name $VUFX\n\n";
- $exit_after_messages = 1;
- }
- if ($help) {
- &usage;
- $exit_after_messages = 1;
- }
- if ($show_lists) {
- print "\n";
- print "These compatibles are hard coded to have no driver.\n";
- print "\n";
- for my $compat (sort keys %compat_white_list) {
- print " $compat\n";
- }
- print "\n\n";
- print "The driver for these compatibles is hard coded (white list).\n";
- print "\n";
- my $max_compat_len = 0;
- for my $compat (sort keys %driver_hard_code_list) {
- if (length $compat > $max_compat_len) {
- $max_compat_len = length $compat;
- }
- }
- for my $compat (sort keys %driver_hard_code_list) {
- if (($driver ne "hardcoded_no_driver") && ($driver ne "no_driver")) {
- my $first = 1;
- for my $driver (@{ $driver_hard_code_list{$compat} }) {
- if ($first) {
- print " $compat";
- print " " x ($max_compat_len - length $compat);
- $first = 0;
- } else {
- print " ", " " x $max_compat_len;
- }
- print " $driver\n";
- }
- }
- }
- print "\n\n";
- print "The configuration option for these drivers is hard coded (white list).\n";
- print "\n";
- my $max_driver_len = 0;
- for my $driver (sort keys %driver_config_hard_code_list) {
- if (length $driver > $max_driver_len) {
- $max_driver_len = length $driver;
- }
- }
- for my $driver (sort keys %driver_config_hard_code_list) {
- if (($driver ne "hardcoded_no_driver") && ($driver ne "no_driver")) {
- my $first = 1;
- for my $config (@{ $driver_config_hard_code_list{$driver} }) {
- if ($first) {
- print " $driver";
- print " " x ($max_driver_len - length $driver);
- $first = 0;
- } else {
- print " ", " " x $max_driver_len;
- }
- print " $config\n";
- }
- }
- }
- print "\n\n";
- print "These drivers are black listed.\n";
- print "\n";
- for my $driver (@black_list_driver) {
- print " $driver\n";
- }
- print "\n";
- $exit_after_messages = 1;
- }
- if ($exit_after_messages) {
- exit 0;
- }
- $exclude_flag_pattern = "[";
- for my $exclude_flag (@exclude_flag) {
- $exclude_flag_pattern = $exclude_flag_pattern . $exclude_flag;
- }
- $exclude_flag_pattern = $exclude_flag_pattern . "]";
- # clean up if empty
- $exclude_flag_pattern =~ s/^\[\]$//;
- $include_flag_pattern = "[";
- for my $include_flag (@include_flag) {
- $include_flag_pattern = $include_flag_pattern . $include_flag;
- }
- $include_flag_pattern = $include_flag_pattern . "]";
- # clean up if empty
- $include_flag_pattern =~ s/^\[\]$//;
- if ($exclude_flag_pattern) {
- my $found = 0;
- for $pr_flag_value (@pr_flag_value) {
- if ($exclude_flag_pattern =~ m/$pr_flag_value/) {
- $found = 1;
- }
- }
- if (!$found) {
- &cmd_line_err("invalid value for FLAG in --exclude-flag\n");
- exit 1
- }
- }
- if ($include_flag_pattern) {
- my $found = 0;
- for $pr_flag_value (@pr_flag_value) {
- if ($include_flag_pattern =~ m/$pr_flag_value/) {
- $found = 1;
- }
- }
- if (!$found) {
- &cmd_line_err("invalid value for FLAG in --include-flag\n");
- exit 1
- }
- }
- if ($include_suspect) {
- $include_flag_pattern =~ s/\[//;
- $include_flag_pattern =~ s/\]//;
- $include_flag_pattern = "[" . $include_flag_pattern . "A-Z]";
- }
- if ($exclude_flag_pattern =~ m/$include_flag_pattern/) {
- &cmd_line_err("the same flag appears in both --exclude-flag and --include-flag or --include-suspect\n");
- exit 1
- }
- # ($#ARGV < 0) is valid for --help, --version
- if ($#ARGV < 0) {
- &cmd_line_err("device-tree... is required");
- exit 1
- }
- if ($config_file) {
- &read_config_file();
- }
- # avoid pushing duplicates for this value
- $driver = "hardcoded_no_driver";
- for $config ( @{ $driver_config_hard_code_list{$driver} } ) {
- push @{ $driver_config{$driver} }, $config;
- }
- if ($white_list_driver) {
- for my $compat (keys %driver_hard_code_list) {
- for my $driver (@{ $driver_hard_code_list{$compat} }) {
- push @{ $compat_driver{$compat} }, $driver;
- if ($driver ne "hardcoded_no_driver") {
- $driver_count{$compat} = scalar @{ $compat_driver{$compat} };
- }
- }
- }
- }
- if ($white_list_config) {
- for my $driver (keys %driver_config_hard_code_list) {
- if ($driver ne "hardcoded_no_driver") {
- for $config ( @{ $driver_config_hard_code_list{$driver} } ) {
- push @{ $driver_config{$driver} }, $config;
- }
- }
- }
- }
- if (-x "scripts/dtc/dtx_diff") {
- $dtx_diff = "scripts/dtc/dtx_diff";
- } else {
- print STDERR "\n";
- print STDERR "$script_name must be run from the root directory of a Linux kernel tree\n";
- print STDERR "\n";
- exit 3;
- }
- for $file (@ARGV) {
- &read_dts($file);
- }
|