[flashrom] [PATCH] flashrom 0.9.2

Michael Karcher flashrom at mkarcher.dialup.fu-berlin.de
Sat May 15 12:46:22 CEST 2010


> @@ -42,10 +45,11 @@
>  option is
>  .B not
>  recommended, you should only use it if you know what you are doing and you
> -feel that the time for verification takes too long.
> +feel that the time for verification takes too long. Please note that flashrom
> +will automatically verify all operations unless you specify \-\-noverify.
Reword the whole paragraph instead of adding the note, like
-n, --noverify
  Skip the automatic verification after writing...
Especially, I don't like "all operations", as the verify is only implied
for write, but read and erase are also "operations".

> +	       /* FIXME: --mainboard should be a programmer parameter */
Right.

> +	       "   -f | --force                      force something\n"
"force specific operations (see man page)" ?

> +	       "   -n | --noverify                   don't auto-verify\n"
> +	       "   -l | --layout <file>              read ROM layout from "
> +	       "file\n"
Style: I would indent "file" up to "read ROM layout". Your choice.

> +#if 0
> +	/* FIXME: This is broken. printf_debug is a no-op because verbose=0
> +	 * at this point.
> +	 */
>  	if (argc > 1) {
>  		/* Yes, print them. */
>  		printf_debug("The arguments are:\n");
>  		for (i = 1; i < argc; ++i)
>  			printf_debug("%s\n", argv[i]);
>  	}
> +#endif
Throw it out completely. Whoever just wants to see the parameters
flashrom is called with should write a wrapper script.

> -				exit(1);
> +				cli_classic_abort_usage(argv[0]);
Don't dump the usage on syntax errors. It clutters output too much so
that you don't find the error message. Just print a one-liner like 'run
"flashrom --help" for usage info'. I especially liked the debian tool
that outputs "You need --help.", but don't recommend this very phrase to
flashrom.

>  			if (programmer == PROGRAMMER_INVALID) {
>  				printf("Error: Unknown programmer %s.\n", optarg);
> -				exit(1);
> +				cli_classic_abort_usage(argv[0]);
>  			}
In this case, list the supported programmers (and just them).

> -		msg_cinfo("VERIFIED.          \n");
> +		msg_cinfo("VERIFIED.\n");
The spaces probably were to clear address counter characters. Did you
verify that it is not needed with current chip drivers?

The remaining stuff looks good, you get a tentative
Acked-by: Michael Karcher <flashrom at mkarcher.dialup.fu-berlin.de>

Regards,
  Michael Karcher





More information about the flashrom mailing list