I'm looking at the official GRUB2 docs for the search command, as found on http://www.gnu.org/software/grub/manual/grub.html#index-searchCommand: search [--file|--label|--fs-uuid] [--set [var]] [--no-floppy] nameSearch devices by file (-f, --file), filesystem label (-l, --label),or filesystem UUID (-u, --fs-uuid).If the --set option is used, the first device found is set as thevalue of environment variable var. The default variable is root.The --no-floppy option prevents searching floppy devices, which can be slow.The search.file, search.fs_label, and search.fs_uuid commands are aliasesfor search --file, search --label, and search --fs-uuid respectively.In section 5.3 there are many examples alongmenuentry FreeBSD {      insmod zfs      search --set=root --label freepool --hint hd0,msdos7      ...}It appears the --hint option is undocumented other than as an example. What does it do exactly? What is the exact format of the argument?
What does the --hint option in grub2's search command do?
grub2
--hint is used to select which partition to select when there are multiple matched partition. By default the 1st matched one is selected.  Suppose there are 2 storage device with label boot  as follows  hd0,msdos1hd1,msdos7then the command :search --set=root --label freepool --hint hd1,msdos7will select hd1,msdos7 instead of hd0,msdos1