Add very basic pages for: isohybrid - It's not particularly more useful than --help, but my QA department really wants this to exist. memdiskfind - Explain what it does and its invocation. Signed-off-by: Peter Jones <pjones at redhat.com> --- man/isohybrid.1 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ man/memdiskfind.1 | 10 +++++++++ 2 files changed, 71 insertions(+) create mode 100644 man/isohybrid.1 create mode 100644 man/memdiskfind.1 diff --git a/man/isohybrid.1 b/man/isohybrid.1 new file mode 100644 index 0000000..21e7a34 --- /dev/null +++ b/man/isohybrid.1 @@ -0,0 +1,61 @@ +.TH isohybrid 1 "17 Jan 2014" "isohybrid" +.SH "NAME" +isohybrid \(em Post-process an ISO 9660 image generated with mkisofs or +genisoimage to allow hybrid booting as a CD-ROM or as a hard disk. +.SH "SYNOPSIS" +.B isohybrid +[\fBOPTIONS\fP] +.I <boot.iso> +.SH "DESCRIPTION" +.PP +The \fBisohybrid\fR utility modifies a an ISO 9660 image generated with +mkisofs, genisoimage, or compatible utilities, to be bootable as a CD-ROM or +as a hard disk. +.SH "OPTIONS" +.TP +\fB-h\fR \fI<X>\fR\fN +.br +Number of default geometry heads +.TP +\fB-s\fR \fI<X>\fR +.br +Number of default geometry sectors +.TP +\fB-e\fR \fI<X>\fR, \fB--entry\fR \fI<X>\fR +Specify parititon entry number (1-4) +.TP +\fB-o\fR \fI<X>\fR, \fB--offset\fR \fI<X>\fR +.br +Specify partition offset (default 0) +.TP +\fB-t\fR \fI<X>\fR, \fB--type\fR \fI<X>\fR +.br +Specify MBR ID (default random) +.TP +\fB-u\fR, \fB--uefi\fB +Build EFI bootable image +.TP +\fB-m\fR, \fB--mac\fB +Add Apple File Protocol partition table support +.TP +\fB--forcehd0\fR +Assume we are laoded as disk ID 0 +.TP +\fB--ctrlhd0\fR +Assume disk ID 0 if the Ctrl key is pressed +.TP +\fB--partok\fR +Allow booting from within a partition +.TP +\fB-?\fR, \fB--help\fR +Display help +.TP +\fB-v\fR, \fB--verbose\fR +Display verbose output +.TP +\fB-V\fR, \fB--version\fR +Display version information + +.SH "SEE ALSO" +.PP +\fBmkisofs\fR(1) diff --git a/man/memdiskfind.1 b/man/memdiskfind.1 new file mode 100644 index 0000000..f0d677c --- /dev/null +++ b/man/memdiskfind.1 @@ -0,0 +1,10 @@ +.TH memdiskfind 1 "17 Jan 2014" "memdiskfind" +.SH "NAME" +memdiskfind \(em Simple utility to find a resident \fBmemdisk\fR instance. +.SH "SYNOPSIS" +.B memdiskfind +.SH "DESCRIPTION" +.PP +The \fBmemdiskfind\fR utility searches memory for a \fBmemdisk\fR instance, +and, if found, outputs the parameters needed to use the \fphram\fR driver in +Linux to map it. -- 1.8.4.2
Op 2014-01-20 om 09:51 schreef Peter Jones:> Add very basic pages for: > isohybrid - It's not particularly more useful than --help, but my QA > department really wants this to exist. > memdiskfind - Explain what it does and its invocation. > > Signed-off-by: Peter Jones <pjones at redhat.com> > --- > man/isohybrid.1 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ > man/memdiskfind.1 | 10 +++++++++ > 2 files changed, 71 insertions(+) > create mode 100644 man/isohybrid.1 > create mode 100644 man/memdiskfind.1 >FWIW: I didn't see any mailinglist response on the provided patch. Neither I can't find the files in "our git". What can I do more then sending this reminder? Cheers Geert Stappers stappers at nero:~/src/syslinux-zytor $ date Sat Feb 1 11:18:40 CET 2014 You have new mail in /var/mail/stappers stappers at nero:~/src/syslinux-zytor $ git branch | grep '^*' * master stappers at nero:~/src/syslinux-zytor $ git config --list | grep url remote.origin.url=git://git.zytor.com/syslinux/syslinux.git stappers at nero:~/src/syslinux-zytor $ git pull Already up-to-date. stappers at nero:~/src/syslinux-zytor $ ls man extlinux.1 gethostip.1 lss16toppm.1 ppmtolss16.1 syslinux.1 syslinux2ansi.1 stappers at nero:~/src/syslinux-zytor $
Hi,> Op 2014-01-20 om 09:51 schreef Peter Jones: > > Add very basic pages for: > > isohybrid - It's not particularly more useful than --help, but my QA > > department really wants this to exist.Geert Stappers wrote:> FWIW: I didn't see any mailinglist response on the provided patch.The pipelines seem to be full. :)) Somehow i missed the post of Peter Jones. Else i would have pointed out that the man page is a lesser problem of isohybrid.c from the viewpoint of QA. utils/isohybrid.c has serious problems with GPT (for EFI isohybrid) and APM (for some Macs with whatever firmware). http://www.syslinux.org/archives/2012-May/017843.html http://www.syslinux.org/archives/2012-May/017871.html I did not propose patches yet, because i'd prefer to have the code of isohybrid.c indepedent of the isohybrid code in libisofs. It would help with future bug hunts. But especially this line here is frightening: memcpy(part->name, "ISOHybrid ISO", 28); Have a nice day :) Thomas
Hi,> # Most linux distros dont have `mkisofs'Or they have genisoimage under the name "mkisofs". (e.g. Debian, Archlinux)> mkisofs \ > -o output.iso \ > -no-emul-boot \ > -boot-info-table \ > -boot-load-size 4 \ > -c isolinux/boot.cat \ > -b isolinux/isolinux.bin \ > ISO_rootI would add option -R or -r for Rock Ridge names and file attributes. This will make appear the files with their original names, as in ISO_root, when the ISO filesystem gets mounted on unix-like systems. (Up to 255 characters of 8 bit each. E.g. UTF-8.) Maybe add option -J for Joliet names, so that Microsoft users do not feel discriminated. (Up to 64 UCS-2 characters of 16 bit each.)> # Could anyone give me an example to do this same thing, using > # `genisoimage', or `xorriso'?The options used in your example (as well as R, -r, -J) are supported by genisoimage and by "xorriso -as mkisofs", too. See also http://wiki.osdev.org/El-Torito#Example_of_ISO_Filesystem_Production_Run_for_BIOS genisoimage is a clone of mkisofs as of 2006, enhanced by several new options to serve the needs of Debian CD image production. xorriso is not a mkisofs clone, but offers a compatibility mode. hpa wrote:> xorriso uses a different command line, as it is a lot more capable.As its developer i will not contradict. :)) For clarification: xorriso's native command interface differs much from mkisofs, in order to make it suitable for dialog operation and for serving as online slave for frontends. Among its commands is -as mkisofs ...mkisofs.options... -- The mkisofs options include all those which are mentioned by the ISOLINUX wiki for mkisofs. The end mark "--" may be omitted if no other xorriso commands shall follow. The complete -as mkisofs option list is shown by xorriso -as mkisofs -help and explained in detail in man xorrisofs http://www.gnu.org/software/xorriso/man_1_xorrisofs.html Some of these options are add-ons which you will not find in mkisofs. Vice versa, several mkisofs options are not supported by xorriso -as mkisofs. Most notably: -udf, -hfs. You may also use xorriso to put the ISO image onto optical media on GNU/Linux, FreeBSD, or Solaris: xorriso -as cdrecord -v blank=as_needed -eject output.iso (Documented in man xorrecord.) Send bug reports or enhancement wishes to me directly or to bug-xorriso at gnu.org Have a nice day :) Thomas