xref: /openbsd/usr.sbin/mksuncd/mksuncd.1 (revision 76d0caae)
1.\"	$OpenBSD: mksuncd.1,v 1.4 2011/12/25 18:22:01 schwarze Exp $
2.\"
3.\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
19.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
24.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd $Mdocdate: December 25 2011 $
28.Dt MKSUNCD 1 sparc64
29.Os
30.Sh NAME
31.Nm mksuncd
32.Nd add a bootable UFS partition to a filesystem image
33.Sh SYNOPSIS
34.Nm mksuncd
35.Ar partition-letter
36.Ar isofile
37.Ar ufsfile
38.Sh DESCRIPTION
39The
40.Nm
41utility adds the file
42.Ar ufsfile
43to the end of
44.Ar isofile .
45.Ar ufsfile
46is assumed to be a bootable filesystem image and
47.Ar isofile
48is assumed to be something like an ISO 9660 filesystem.
49A Sun-style disklabel is expected to already be present
50at the beginning of
51.Ar isofile ,
52and
53.Nm
54will update that label so that the partition (a-h) given by
55.Ar partition-letter
56points to
57.Ar ufsfile
58within
59.Ar isofile .
60.Pp
61Based on the label in
62.Ar isofile ,
63that file is padded so that added files are always on cylinder boundaries.
64This is a requirement of the PROM.
65.Sh BUGS
66This program is not endian or type safe.
67It makes several assumptions about both based on its
68SPARC bias.
69