From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1UDYfK-0006j5-UY for mharc-grub-devel@gnu.org; Thu, 07 Mar 2013 06:07:14 -0500 Received: from eggs.gnu.org ([208.118.235.92]:60805) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UDYfH-0006i6-14 for grub-devel@gnu.org; Thu, 07 Mar 2013 06:07:13 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UDYfD-0001ao-EG for grub-devel@gnu.org; Thu, 07 Mar 2013 06:07:10 -0500 Received: from mail-wg0-f43.google.com ([74.125.82.43]:46265) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UDYfD-0001aj-1T for grub-devel@gnu.org; Thu, 07 Mar 2013 06:07:07 -0500 Received: by mail-wg0-f43.google.com with SMTP id e12so521364wge.34 for ; Thu, 07 Mar 2013 03:07:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:message-id:date:from:user-agent:mime-version:to:subject :references:in-reply-to:x-enigmail-version:content-type; bh=HutPx2fW6+mePo9V2es0jAfMZmnJwpkKIlUZJeTMf2w=; b=p175nYcDEGVYSXLzxcwzBVLmudiJ03kZOK1BgODq6iXzjW0gsdtTsnVV1ITPTyFGau yD4+1jrwfqm4n+XFq8b9HuICGHlhG+wSBV3tLb3jxP5yh9ThTpagmWzsLuNXQ8+HkcR3 eSznnI9HN5D9U64GbdIBUi78iLKDNxxIiRxI0Xmibzvm/joK4sI62mll9Ok2uzLnTEde YE5fIZ8uJdDP3OWuGcJjYSsCCw0Jtb4aKSffigLaddIqVldDib3gW8usdq4W7I5iiyVF I/pzowkoI3/bGex8r09V/ptZa1aFSztCrSYazvNcm5MN6BvQB5NaHeyipuDQcAg3nO2u 02Kw== X-Received: by 10.180.87.129 with SMTP id ay1mr25986213wib.1.1362654426179; Thu, 07 Mar 2013 03:07:06 -0800 (PST) Received: from debian.x201.phnet ([217.193.148.98]) by mx.google.com with ESMTPS id n10sm2069298wia.0.2013.03.07.03.07.03 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 07 Mar 2013 03:07:05 -0800 (PST) Message-ID: <513874D0.7090306@gmail.com> Date: Thu, 07 Mar 2013 12:06:56 +0100 From: =?UTF-8?B?VmxhZGltaXIgJ8+GLWNvZGVyL3BoY29kZXInIFNlcmJpbmVua28=?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:10.0.12) Gecko/20130116 Icedove/10.0.12 MIME-Version: 1.0 To: The development of GNU GRUB Subject: Re: Command documentation part 1. References: <20130122170851.1bb50f87@opensuse.site> <20130122171218.GA9543@riva.dynamic.greenend.org.uk> <20130129142517.44838703@opensuse.site> <51163783.7030006@gmail.com> <20130224114056.4cd4a5b0@opensuse.site> In-Reply-To: <20130224114056.4cd4a5b0@opensuse.site> X-Enigmail-Version: 1.4.1 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="------------enigF113A78500B1E3B76DFE3754" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 74.125.82.43 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: The development of GNU GRUB List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Mar 2013 11:07:13 -0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enigF113A78500B1E3B76DFE3754 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 24.02.2013 08:40, Andrey Borzenkov wrote: > =20 > @menu > +* [:: Check file types and compare values > * acpi:: Load ACPI tables > +* authenticate:: Check whether user is in user list > +* background_color:: Set background color for active termin= al > +* background_image:: Load background image for active termi= nal These are specific to gfxterm, not generic how your patch would suggest. > +* md5sum:: Calculate MD5 hash It also checks. This is an alias to hashsum > +* sha1sum:: Calculate SHA1 hash > +* sha256sum:: Calculate SHA256 hash > +* sha512sum:: Calculate SHA512 hash ditto > +* vbeinfo:: List available video modes vbeinfo is a compatibility alias and is reserved for VBE. Perhaps we should start having commands specifically excluded from help lists to discourage their use > +@node background_color > +@subsection background_color > + > +@deffn Command background_color color > +Set background color for active terminal. For valid color specificatio= ns see > +@pxref{Theme file format, ,Colors}. > +@end deffn > + > + > +@node background_image > +@subsection background_image > + > +@deffn Command background_image [[@option{--mode} @samp{stretch}|@samp= {normal}] file] > +Load background image for active terminal from @var{file}. Image is st= retched > +to fill up entire screen unless option @option{--mode} @samp{normal} i= s given. > +Without arguments remove currently loaded background image. > +@end deffn Ditto. gfxterm-specific > +@node cmosclean > +@subsection cmosclean > + > +@deffn Command cmosclean byte:bit > +Clear value of bit in CMOS at location @var{byte}:@var{bit}. This com= mand > +is available only on PC BIOS platform. > +@end deffn It's available on all platforms featuring CMOS which are all x86 (including EFI, coreboot, ieeee1275, and so on), Loongson, Qemu-mips and some IEEE1275 platforms (determined at runtime). GROUPS["cmos"] =3D GROUPS["x86"][:] + ["mips_loongson", "mips_qemu_mips",= "sparc64_ieee1275", "powerpc_ieee127= 5"] > + > + > +@node cmostest > +@subsection cmostest > + > +@deffn Command cmostest byte:bit > +Test value of bit in CMOS at location @var{byte}:@var{bit}. Exit statu= s > +is zero if bit is set, non zero otherwise. This command is available o= nly > +on PC BIOS platform. > +@end deffn > + Ditto. > -@deffn Command crc file > -Display the CRC32 checksum of @var{file}. > +@deffn Command crc arg @dots{} > +Alias for @code{hashsum --hash crc32 arg @dots{}}. See command @comman= d{hashsum} > +(@pxref{hashsum}) for full description. > +@end deffn > + > + > +@node cryptomount > +@subsection cryptomount > + > +@deffn Command cryptomount device|@option{-u} uuid|@option{-a}|@option= {-b} > +Setup access to encrypted device. If necessary, passphrase > +is requested interactively. Option @var{device} configures specific gr= ub device > +(@pxref{Naming convention}); option @option{-u} @var{uuid} configures = device > +with specified @var{uuid}; option @option{-a} configures all encrypted= devices; Only the ones GRUB supports > +option @option{-b} configures all partitions that have boot flag set. Last part is wrong. It refers to boot flag in geli container, not the one in partmap. Also I think it's worth mentioning that luks/geli/... aren't autoloaded. > +@node hashsum > +@subsection hashsum > + > +@deffn Command hashsum @option{--hash} hash @option{--keep-going} @opt= ion{--uncompress} @option{--check} file [@option{--prefix} dir]|file @dot= s{} > +Compute or verify file hashes. Hash type is selected with option @opti= on{--hash}. > +Supported hashes are @samp{crc32}, @samp{md5}, @samp{sha1}, @samp{sha2= 56}, > +@samp{sha512}. Much more hashes are supported. Currently: ADLER32: adler32 CRC64: crc64 CRC32: gcry_crc CRC32RFC1510: gcry_crc CRC24RFC2440: gcry_crc MD4: gcry_md4 MD5: gcry_md5 RIPEMD160: gcry_rmd160 SHA1: gcry_sha1 SHA224: gcry_sha256 SHA256: gcry_sha256 SHA512: gcry_sha512 SHA384: gcry_sha512 TIGER192: gcry_tiger TIGER: gcry_tiger TIGER2: gcry_tiger WHIRLPOOL: gcry_whirlpool > +When option @option{--check} is given, it points to a file that contai= ns > +list of @var{hash name} pairs. File hash and file name are separated b= y > +single @key{SPACE} or @key{TAB}, one pair on a line. Option @option{--= prefix} > +may be used to give directory where files are located. Hash verificati= on > +stops after the first mismatch was found unless option @option{--keep-= going} > +was given. > +@end deffn This is the same format as used by standard UNIX tools. > @@ -4147,6 +4372,74 @@ will not be shown immediately. > @end deffn > =20 > =20 > +@node test > +@subsection test > + > +@deffn Command test expression > +Evaluate @var{expression} and return zero exit status if result is tru= e, > +non zero status otherwise. > + > +@var{expression} is one of: Did you copy it from somewhere else? Please specify all parts copied from anywhere else. --------------enigF113A78500B1E3B76DFE3754 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iF4EAREKAAYFAlE4dNAACgkQNak7dOguQgkRAQD/XwKACUvQdOSF5qmYlgIG7Jvp PtSvygIeeuxTCuPfVngA/1xI6bJUaHbP5mmRcDoNWkqFTr9BZDyW6+cG2PlmexlF =fTnX -----END PGP SIGNATURE----- --------------enigF113A78500B1E3B76DFE3754--