cvs commit: src/sbin/mdconfig mdconfig.8

[Bruce Evans]

On Fri, 18 May 2007, Giorgos Keramidas wrote:

> On 2007-05-18 16:41, Kris Kennaway <kris at obsecurity.org> wrote:
>> On Fri, May 18, 2007 at 01:57:17PM +0000, Giorgos Keramidas wrote:
>>> keramida    2007-05-18 13:57:17 UTC
>>>
>>>   FreeBSD src repository (doc committer)
>>>
>>>   Modified files:
>>>     sbin/mdconfig        mdconfig.8
>>>   Log:
>>>   Add an example which shows how mdconfig(8) can be used
>>>   to mount an ISO 9660 CD image file.

I'm not sure this example should exist.  There is not much special about
cd9660 images.  The previous example works for all types of images, except
it spells the mount command as plain "mount" so ffs is implied, but there
are proposals or commits to determine the filesystem type automatically.

Bugs in this example:
- it says "To mount", but it actually creates an md disk and mounts a
   file system.
- it spells the mount command as mount_cd9660 instead of "mount -t cd9660".

Bugs in nearby examples:
- the previous one says "To create ... a disk", but it actually creates
   a mounted file system (it creates 3 things and mounts 1).

>>>
>>>   PR:             112691
>>>   Submitted by:   Warren Block, wblock at wonkity.com
>>>   MFC after:      3 days
>>
>> An interesting trick is that bsdtar can read ISO files without needing
>> to mount them - I wonder if a cross-reference is appropriate.
>
> Good idea.  I don't know right now of a good way to reference bsdtar,
> but maybe we can extend the sample with something like:
>
>     The bsdtar(1) utility can also be used to peek into ISO 9660 CD
>     images, or even to ``extract'' files from them.
>
> or would a reference like this be more appropriate to mount_cd9660(1),
> in a part of the manpage which points to mdconfig(8) and bsdtar(1)?

Even bsdtar itself doesn't document this explicitly, at least in 6.2.
It points to libarchive(5) for the complete list of supported formats.

Bruce