gmane.os.netbsd.documentation

More typos and suggestions

Michael — 2013-05-07T12:10:51

Hello,

I would like to tell you about some bugs I've recently encountered, along with ideas of possible enhancement.

The NetBSD Guide, 27.1.1 Configuration of generic mapping
smtp_generic_maps = hash:/etc/postfix/generic
The variable does not exist anymore. After a long time spent searching the web, I found out it has been renamed to "sender_canonical_maps", and either it's not mentioned in the manpages, or I simply overlooked it.

It would be nice to see some more examples, like this one, that allows the use of gmail, who require authentication and encryption:
smtp_use_tls = yes
smtp_sasl_auth_enable = yes
relayhost = [smtp.gmail.com]:587
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options =
sender_canonical_maps = hash:/etc/postfix/generic
message_size_limit = 20480000
The contents of sasl_passwd are:
# destination                   credentials
[smtp.gmail.com]:587mike.d.ft402:p4$$W0rD
# [mail.isp.example]:submission username:password
It and sasl_passwd.db must have proper mode (640?) so that random people can not see their contents.

The "message_size_limit" variable is very useful on its own, for emails nowadays may contain large attachments, and might fail to be delivered locally. If you run fetchmail from cron, that might give an illusion of having no incoming mail.

Speaking of cron, it would be nice to mention it in "27.2 fetchmail", for this saves the trouble of checking mail manually once in a while.

Some minor typos I've found elsewhere:
The NetBSD Guide
13.10 Using a CD-R writer with data CDs
s/an pre-existing/a pre-existing/
27.1.1 Configuration of generic mapping
s/need change/need to change
The Pkgsrc Guide
4.2.2. Fetching distfiles
s/holding/are holding/
9.15. Why do some packages ignore my CFLAGS?
s/so bad code/code so badly/

I was not sure where to mail about this, so I decided to put it with the rest:
The message of "cdrtools -atip"
s/Unformated/Unformatted

Sincerely,
Mike

Style guide for Markdown?

Julian Djamil Fagir — 2013-03-21T21:30:08

Hi,

converting to Markdown is easy, but there are some things underspecified
(e.g., how to reference commands). Call me a nitpicker, but this is a style
guide I roughly thought about. I don't want to enforce it for anyone, just
hear some comments.

Regards, Julian


# Style guide for NetBSD documentation

Markdown is a very liberal language in what range of input it accepts,
rendering all the same output although looking very different.

This is a proposal how to write NetBSD documentation. It is not necessary to  
strictly adhere it, but for the sake of unity and readability, the last two 
sections about *Code and keywords* and *Referencing manpages* should be read.


# Using lists

Lists should be indented by a space, an asterisk, and a space again. Text on  
that list level should then continue with three spaces indented.
Deeper list levels should continue the same pattern, just starting with the 
indentation. I.e., second-level lists should be started by four spaces, then
an asterisk, then a space; following lines should be indented by six spaces,
etc.

Bad:

* structures
  * files
  * sockets

Good:

 * structures
    * files
    * sockets

For numbered lists, you should try to keep the numbering right, even when
only in textmode. You indent each level by four characters, with the list
item being started by a space, a `1.`, and a space. For numbered lists with
more than nine elements, drop the space in the beginning, i.e. do a `10.`,
then a space, then the item.

Bad:

1. Introduction
1. Welcome

Good:

 1. Introduction
 2. Welcome


# Using headers

Put either one or two whitelines before a header, depending on the importance
of the header (rough: two lines for first and second level, one whiteline for 
everything below).

Don't use setext headers, only ATX headers. I.e., not the ones which have a
line of dashes or equals signs following, but only the ones which have a
single line, started by hash signs. Don't put hash signs at the end of a
header.

Bad:

    Chapter 1. Introduction
    ================

Good:

    # Chapter 1. Introduction

Don't use special characters in a header - it should consist only of  
alphanumeric characters.

Bad:

    # The file `/etc/hosts`

Good:

    # The file /etc/hosts


# Image captions

When you place an image in an article, separate it into its own paragraph.
Make a linebreak, then place in bold letters the caption of the image.

Bad:

    Then you see the welcome screen:
    **Welcome screen*
    ![welcome screen](/welcome.jpg)
    After pressing the *Home* button, you will get to..

Good (notice two spaces after the image line):

    Then you see the welcome screen:

    ![welcome screen](/welcome.jpg)
    **Welcome screen*

    After pressing the *Home* button, you will get to...


# Referencing manpages

Reference manpages once per section, i.e. write them down in NAME(SECTION)
notation:

    sh(1)

After that, don't write the commands in monospace or italic, only when you
want people explicitly to call them. See below for further information.


# Code and keywords

When displaying code, indent it by four spaces, not more - only when it is
part of the code (i.e., indentation).

Bad:

        int main(int argc, char *argv[]) {
          return 0;
        }

Good:

    int main(int argc, char *argv[]) {
        return 0;
    }

When asking a user to execute a command, do this by putting the text into
single quotes (or, when quotes are part of the text, more):

Bad:

    Now, we have to **restore -i**, to get back the information.

Good:

    Now, we have to `restore -i`, to get back the information.

For more important or longer commands, put them in a single code environment
indented by four spaces. Each command line should be prepended by a hash sign
and a space.

Bad:

    Now, we have to `openssl enc -pass 12345 | tar -c -f file.tgz`.

Good:

    Now, we have to do

        # openssl enc -pass 12345 | tar -c -f file.tgz

When referencing a command without asking the user to execute it, just leave
it untouched - many commands are then used as verbs themselves, and putting
them separately would look strange. Only do this if you referenced it before
as a manpage.

Bad:

    Now, you have to **tar** the file, then pass it to `openssl` to decrypt.

Good:

    Now, you have to tar the file, then pass it to openssl to decrypt.

Legal questions: Copyright notices

Julian Djamil Fagir — 2013-03-21T11:35:32

Hi,

when looking at the {NetBSD,internals,pkgsrc} guide, you always see the
acknowledgements and copyright notices separately, and blabla, NetBSD is a
registered trademark.
I wonder: How should such things be handled in the wiki? Is there need for a
copyright by TNF? Is there need for a trademark note? Do we have to tell
everyone that registered trademarks of their respective owners, etc.?
How should achknowledgements be handled? Put them in the commit messages, or
continue having them separately?
Do we have the possibility to add comments in ikiwiki, to put licences in? Or
should we make them public?
What is the default licence?

Regards, Julian

Ѷ ɬ Ḁ ɡ ř Ḁ

Muriel Burchett — 2013-03-17T14:56:58

http://www.stanlloret.com/phpMyAdmin/_items.php?p9544516

CD-ROM information on NetBSD website

Luc van der Veen — 2013-03-09T21:04:43

Hi,

This page:
http://netbsd.org/releases/index.html#formal
says NetBSD 6.0.1 CD-ROMs can be ordered, but the next page does not list places 
offering anything after 5.0.1.
I have not found any site offering 6.0.1 with Google...

Kind regards,

What is the licence of nb documentation?

Julian Djamil Fagir — 2013-02-26T11:29:51

Hi,

I'm wondering: What is the licence of the documentation?
The Guide contains information about it, but the wiki and the website?

Regards, Julian

announcing mdoc.su, a deterministic man-page URL shortener

Constantine A. Murenin — 2013-02-18T21:49:49

Dear NetBSD,

I would like to announce and introduce http://mdoc.su/ , 
a deterministic URL shortener for BSD manual pages, 
written entirely in nginx.conf.

It supports several address schemes, for example:

http://mdoc.su/NetBSD/3X11/XFree
http://mdoc.su/netbsd/macppc/4/intro
http://mdoc.su/n/intro.4.macppc
http://mdoc.su/n/mdoc.7
http://mdoc.su/n/curl

Source code for the whole mdoc.su.nginx.conf is available at:
https://github.com/cnst/mdoc.su
https://bitbucket.org/cnst/mdoc.su

Specifically, the following currently (as of 2013-02-17) controls 
NetBSD rewriting, and best describes the access scheme for NetBSD:

location /NetBSD {rewrite^/NetBSD(/.*)?$/n$1;}
location /n {
set$nb"http://netbsd.gw.com/cgi-bin/man-cgi?";
rewrite^/netbsd(/.*)?$/.$1;
rewrite^/./([a-z]+[0-9]*[kx]?)/([^/]+)/([^/]+)$$nb$3+$2.$1redirect;
rewrite^/./([^/]+)/([^/]+)$$nb$2+$1redirect;
rewrite^/./([^/]+)\.([1-9]\.[a-z]+[0-9]*[kx]?)$$nb$1+$2redirect;
rewrite^/./([^/]+)\.([1-9])$$nb$1+$2redirect;
rewrite^/./([^/]+)$$nb$1redirect;
rewrite^/./?$/last;
return404;
}

Basically, "/NetBSD" and "/netbsd" are rewritten to "/n" internally 
(with no extra reply to the user), and then the rest of the URI is 
analysed, and a "302 Found" redirect is finally issued to the user.

Pages like http://mdoc.su/n/ redirect to the main "/" page internally, 
without affecting the URL that's visible to the user, making it easier 
to keep as a starting page specifically for one BSD.

Comments and suggestions are very welcome.  I've noticed there is an 
inconsistency between the available sections on these man-cgi scripts 
and the actual data that they can access:  for example, only "X11R6" 
is listed on NetBSD's man-cgi, not "3X11", and, likewise, 3p is missing 
from OpenBSD's man.cgi, although http://mdoc.su/o/sort.3p works great.  
It would be nice if people more familiar with the organisation of 
manual pages would provide some insights on restricting or relaxing the 
current rewrites to be more conforming.

Also, is there a preferred method of referring to a certain page through a URL?  

What looks better:  mdoc.su/n/8/envstat  or  mdoc.su/n/envstat.8 ?  
Although the "/8/sysctl" style seems to be more popular with various 
static man-page collections and web-sites, and is potentially more flexible, 
especially for NetBSD, I nonetheless think that for the simple [1-9] sections 
the "/sysctl.8" style looks better and more familiar.

P.S. Mail-Followup-To: NetBSD-Docs< at >NetBSD.org.

Best regards,
Constantine.

awk FS magic

James K. Lowden — 2013-02-15T22:54:18

The -F option for awk is more clever than the manual says.  Do we want
the behavior, or is the manual right?  

I noticed a working bug in a little script that led to this suprising
result:

$ echo foo | awk -F t '{print FS}' | hexdump -C
00000000  09 0a                                             |..|
00000002

If the argument to the -F option is

t

awk assumes you meant '\t' and sets the FS variable to TAB.  That's not
mentioned in the manual.  Apparently the only way to use the letter 't'
as a field separator is with the regex '[t]'.

I'm sure that's meant to help the clueless, because I found myself
taking advantage of it in my own script

        |  grep -f /etc/whitelist.dat   \
        |  awk -F\t '{print $2}'  \
        |  sed s'/[<>]//g'  \

even though I had no right to expect it to work.  

This appears to be the only specially treated character.  The relevant
function is setfs().  It has a pithy comment inside conditional
compilation:

static char *
setfs(char *p)
{
#ifdef notdef
        /* wart: t=>\t */
        if (p[0] == 't' && p[1] == 0)
                return "\t";
        else
#endif
        if (p[0] != 0)
                return p;
        return NULL;
}

I find no support for this "wart" at the open group
(http://pubs.opengroup.org/onlinepubs/9699919799/utilities/awk.html).
Maybe we should just change the Makefile?  

--jkl

Вот наша раскрутка реально приносит прибыль.

Олюша Тарасова — 2013-02-12T08:03:24

http://connemara.seguret.chez.com/download/u1.php

Invitation - Please Complete Your Profile

Richard M. Harris — 2013-01-29T23:12:06

FROM: Worldwide Registry for Business Professionals
TO: netbsd-docs< at >netbsd.org
RE: Worldwide Registry Publication

Hello,

You were recently chosen to represent your professional
community, deeming you eligible for the inclusion in
the new 2013 Edition of Worldwide Registry for Business
Professionals.

We are pleased to inform you that your candidacy was
formally approved on October 1st, 2012. Congratulations!

Click the link below to verify your profile and accept
the candidacy:

http://www.controlnotice.com/link.php?M=170972&N=35&L=3&F=T

The Publishing Committee selected you as a professional based not
only upon your current standing, but focusing as well on criteria
from executive and professional directories, associations, and
trade journals. Given your background, the Director believes your
profile makes a fitting addition to our publication.

There is no fee nor obligation to be listed. As we are working
off of secondary sources, we must receive verification from you
that your profile is accurate. After receiving verification, we
will validate your registry listing within seven business days.

Once finalized, your listing will share prominent registry space
with thousands of fellow accomplished individuals across the
globe, each representing accomplishment within their own
geographical area.

To verify your profile and accept the candidacy, please click this
link:

http://www.controlnotice.com/link.php?M=170972&N=35&L=3&F=T

Please kindly note that our registration deadline for next year's
publication is January 31st, 2013. To ensure you are included,
we must receive your verification on or before this date.

On behalf of our Committee I salute your achievement and welcome
you to our association.

Sincerely yours,

Richard M. Harris
Vice-President, Publication Division
Worldwide Registry for Business Professionals
http://www.controlnotice.com/link.php?M=170972&N=35&L=3&F=T

132 Willow Oaks Lane
Lake Charles, LA 70601

If you would like to update your communication preferences,
please click the link below:

http://www.controlnotice.com/unsubscribe.php?M=170972&C=444967eacd2757a058b664a7065d1a7b&L=14&N=35

Perdi il tuo peso facilmente

Centro Diete — 2013-01-28T19:59:27

Ora puoi farlo! E puoi farlo molto semplicemente;con il nuovo metodo NDT24.

http://tinyurl.com/biodimagrire


E' garantito!


mailto:removemsl< at >katamail.com se non vuoi piu aggiornamenti sulle novita' dimagranti

Nyomkövető: autód, gyereked, kutyád mostantól biztonságban van

Tóth Andrea — 2013-01-28T15:21:54

Hello!

http://www.akciosakcio.com/

Ez az az oldal, ahol a filmekből ismert nyomkövetőt lehet
kapni.Nagyon durva, tényleg űrtechnika, SIM-kártyával
működik, és lekövethetsz bármit vagy bárkit. Kocsit,
kutyát, nagyszülőt, gyereket, hűtlen házastársat :)

Eddig háromszor enyiért láttam és havidíjjal, azért ajánlom
ezt az oldalt, mert itt baromi olcsó és csak egyszer kell fizetni!

http://www.akciosakcio.com/


Andi



















Leiratkozás:
http://adesings.com/email2u08/unsubscribe.php?M=1107909&C=1f996623746e5e0bab59cefa3567512a&L=222&N=3

A typo in the Guide.

Mike Danilov — 2013-01-28T13:29:06

Grettings,

I've found an error in the Guide from 120101, that can slightly affect 
the understanding.
Pp. 227, 235 - "lose" should be used instead of "loose".

Sincerely,
Mike

Organize seu Depto FINANCEIRO!

ELOCURSOS — 2013-01-26T21:44:01

Todas as planilhas por apenas R$ 29,90.

 

Clique sobre o nome para assistir o vídeo de apresentação:

 <http://www.youtube.com/watch?v=5uXVSUi4MNo> Fluxo de caixa

 <http://www.youtube.com/watch?v=-T24BVNNiug> Controle diário de caixa

 <http://www.youtube.com/watch?v=GVTo159odnQ> Controle contas a receber

 <http://www.youtube.com/watch?v=-TGer3nWClU> Controle cobrança por telefone

 <http://www.youtube.com/watch?v=5x1dOKud2C0> Controle cartões de crédito

 <http://youtu.be/pP34Cj2IxjU> Planilha calculo de juros

 <http://youtu.be/22GLw3Ox5aE> Planilha planejamento

Todas as planilhas são elaboradas no sistema de banco de dados, após,
atualizadas geram relatórios dinâmicos. Dessa forma os dados são
transformados em informações úteis para a tomada de decisões.

 

 

Envio todas as planilhas após confirmação do deposito.

 

Banco Bradesco

Ag 0046-9

C/C 0568009-3

Favor: Silvana Jaqueline Guimarães

CPF: 325.250.898-20

 

Precisando de ajuda para elaborar uma planilha? Conte comigo!

 

--

Grato,

Elenildo Verissimo

 <mailto:elenildoverissimo< at >gmail.com> elenildoverissimo< at >gmail.com

 <mailto:contato< at >elocursos.com.br> contato< at >elocursos.com.br

(19) 8816-0579 | 8155-3931

P  Antes de imprimir, pense no Meio Ambiente.

Vogliamo stupirvi con effetti speciali: scegliete fra i nostri 8 regali

Roberta — 2013-01-24T09:34:52

Il nostro staff professionale risponde al 02 365 22 990. 


Scoprite la gamma completa della telefonia professionale
Più di 100 000 clienti si fidano di noi dal 1999 - 1800 referenze sempre presenti a stock



   * IVA esclusa

    Informativa di riservatezza  (D.Lgs.
   196/2003) Gli indirizzi di posta elettronica utilizzati per inviare questo  messaggio,
   indirizzato esclusivamente a soggetti economici, sono stati tratti da elenchi pubblici
   o sono stati raccolti in occasione  di precedenti contatti. I dati vengono  utilizzati
   esclusivamente per segnalare offerte  riservate ad operatori  economici e non  vengono
   comunicati a  terzi,  né  diffusi.  Titolare del  trattamento  è  Onedirect  srl,  Via
   Caracciolo 20 -  20155 Milano,  cui ci si  può rivolgere  per aggiornare,  modificare,
   correggere i dati  o per richiedere  la cancellazione :
   http://trc.emv2.com/J?a=ENX7CqW3IPxO8SA9MKL8XQfnGHxKCs0t2fcStGb5lw8W0bBhOG5mpqVsje_HxHDThlMI

1 millió forint 10 évre 11.530 Ft / hó - Nálunk a bar lista sem akadály!

Ön kaphat hitelt? — 2013-01-23T18:14:59

Tisztelt Hölgyem / Uram!


Hitelre van szüksége? Meglévő drága hitelét olcsóbbra cserélné?
A legolcsóbb működő hitelmegoldást keresi? MEGTALÁLTA!

1 millió forint 10 évre 11.530 Ft / hó
5 millió forint 20 évre 38.297 Ft / hó
Tud ennél olcsóbbat?


NINCS KHR/BAR vizsgálat
Előzetes költség: NINCS!
Csak BANKI hitel, NEM fogyasztói csoport!
Akár 24 órán belüli utalás
Forint alapon árfolyamkockázat nélkül 
NEM szükséges ingatlandfedezet 
POBLÉMÁS  ügyfeleknek banki megoldások! 
Meglévő hitelét váltsa kedvezőbbre árfolyamkockázat nélkül! 
Igényelhető hitelösszeg: 100eft - 35MFt

http://www.akcioshitel.com/

MOST könnyebben és gyorsabban kap hitelt!

Kalkuláció: http://www.akcioshitel.com/
Regisztráljon és kattintson most a kalkuláció gombra!

Köszönjük, hogy minket választott!


Üdvözlettel:
Akcioshitel.com csapata
















Leiratkozás:
http://theenvied.com/email2u05/unsubscribe.php?M=1107909&C=1f996623746e5e0bab59cefa3567512a&L=222&N=14

This may be interesting 4 u

Gemma Stonecipher — 2012-12-17T09:17:38

One of my friends offered me to send the mail and know you a little bit closer! I hope you wouldn't be against of it. 
My name is Jodie! I'm 23 yo and I am learning in university. 
Here I'm looking forward to find a nice male just to talk, to go to club, maybe travel or even create serious relations. 
I hope one of my friends was right and that u are really the male that I am interested in finding!

Newestly

2012-12-05T05:23:49

Hello, its me.   Lyman Hall  http://dentist.inuae.net/rabota.html

http://www.netbsd.org/developers/releng/pullups.html

Ryo ONODERA — 2012-11-30T13:27:21

Hi,

NetBSD 4 retires, and pullup-4< at > e-mail address should be removed
from the website.

Do we have releng-6< at > e-mail address?

The following patch is acceptable?

Index: pullups.xml
===================================================================
RCS file: /cvsroot/htdocs/developers/releng/pullups.xml,v
retrieving revision 1.14
diff -u -r1.14 pullups.xml
--- pullups.xml21 Mar 2012 15:06:30 -00001.14
+++ pullups.xml30 Nov 2012 13:24:31 -0000
< at >< at > -35,9 +35,6 < at >< at >
           <listitem>NetBSD 5 pull-ups go to 
           <email>pullup-5</email>
           </listitem>
-          <listitem>NetBSD 4 pull-ups go to 
-          <email>pullup-4</email>
-          </listitem>
           <listitem>NetBSD pkgsrc pull-ups go to 
           <email>pullup-pkgsrc</email>
           </listitem>
< at >< at > -49,6 +46,9 < at >< at >
         <para>Specific release issues/concerns should go to the
         appropriate list:</para>
         <itemizedlist>
+          <listitem>NetBSD 6 goes to 
+          <email>releng-6</email>
+          </listitem>
           <listitem>NetBSD 5 goes to 
           <email>releng-5</email>
           </listitem>

--
Ryo ONODERA // ryo_on< at >yk.rim.or.jp
PGP fingerprint = 82A2 DC91 76E0 A10A 8ABB  FD1B F404 27FA C7D1 15F3

review mkubootimage.1 manual

Jeremy C. Reed — 2012-11-29T05:10:48

Here is a draft of a mkubootimage(1) man page. Please note that I do not 
use this tool, but provided this manual since it was missing. Please 
fill in the holes and improve this. I cc'd a few developers who I think 
have used it.

.\"$NetBSD$
.\"
.\" Copyright (c) 2008 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
.\" by Jeremy C. Reed
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd November 28, 2012
.Dt MKUBOOTIMAGE 1
.Os
.Sh NAME
.Nm mkubootimage
.Nd create U-Boot loader image
.Sh SYNOPSIS
.Nm
.Fl A No ( arm Ns | Ns mips Ns | Ns mips64 Ns | Ns powerpc )
.Fl a Ar address
.Op Fl C No ( bz2 Ns | Ns gz Ns | Ns lzma Ns | Ns lzo Ns | Ns none )
.Op Fl E Ar address
.Op Fl e Ar address
.Op Fl h
.Op Fl m Ar magic
.Fl n Ar image
.Op Fl O No ( freebsd Ns | Ns linux Ns | Ns netbsd Ns | Ns openbsd )
.Fl T No ( fs Ns | Ns kernel Ns | Ns ramdisk Ns | Ns standalone )
.Ar source destination
.\"
.Sh DESCRIPTION
The
.Nm
utility is used to create an image for Das U-Boot, the
.Qq Universal Boot Loader .
.Pp
The arguments are as follows:
.Bl -tag -width indent
.It Fl A No ( arm Ns | Ns mips Ns | Ns mips64 Ns | Ns powerpc )
Defines the architecture.
This is required.
.It Fl a Ar address
Sets the image load address.
This is an integer between 0 and ULONG_MAX.
This is required.
.It Fl C No ( bz2 Ns | Ns gz Ns | Ns lzma Ns | Ns lzo Ns | Ns none NS )
.\" TODO: fix the ) ] at end of above
Defines the compression.
The default is
.Qq none .
.It Fl E Ar address
Define the entry point.
This is an integer between 0 and ULONG_MAX.
This option is the same as
.Fl e
but it inverts the bytes to convert the 32 bit integer
from little to big endian (or vice versa).
If
.Fl E
or
.Fl e
are not set, the entry point defaults to the
image load address
.Pq Fl a .
.It Fl e Ar address
Define the entry point.
This is an integer between 0 and ULONG_MAX.
If
.Fl E
or
.Fl e
are not set, the entry point defaults to the
image load address
.Pq Fl a .
.It Fl h
Display the usage and exit.
.It Fl m Ar magic
Set the magic.
This is an integer between 0 and ULONG_MAX.
The default is
.Qq 0x27051956.
.\" TODO: confirm that magic default?
.It Fl n Ar image
Defines the image name.
This is required.
.It Fl O No ( freebsd Ns | Ns linux Ns | Ns netbsd Ns | Ns openbsd )
.\" TODO: fix the ) ] at end of above
Defines the operating system type.
The default OS name is
.Qq netbsd .
.It Fl T No ( fs Ns | Ns kernel Ns | Ns ramdisk Ns | Ns standalone )
Defines the image type.
This is required.
.El
.Pp
The required
.Ar source
argument is the filename of the kernel that is read.
The required
.Ar destination
argument is the filename of the image file that is created.
.\"
.Sh RETURN VALUES
.Nm
returns 1 on failure to read the kernel,
generate a header, or create the image.
.\"
.Sh EXAMPLES
Before the image is written, the header is displayed to standard out;
for example:
.Bd -literal -offset 0
 magic:       0x27051956
 time:        Tue Jun  7 15:58:41 2011
 size:        2482203
 load addr:   0x00020000
 entry point: 0x00020000
 data crc:    0x700fdf53
 os:          2 (netbsd)
 arch:        7 (powerpc)
 type:        2 (kernel)
 comp:        1 (gz)
 name:        NetBSD/evbppc 5.99.52 (INSTALL_PMPPC)
 header crc:  0x94ea96cf
.Ed
.\" TODO: check the name line above
.\" .Sh FILES
.Sh SEE ALSO
.Qq Das U-Boot - the Universal Boot Loader
.Pa http://www.denx.de/wiki/U-Boot/
.\"
.\" .Sh STANDARDS
.\"
.Sh HISTORY
The
.Nm
command first appeared in
.Nx 6.0 .
.\"
.Sh AUTHORS
The
.Nm
utility was originally written by Jared D. McNeill.
This manual page was written by Jeremy C. Reed.
.\" .Sh CAVEATS
.\" .Sh BUGS
.\" .Sh SECURITY CONSIDERATIONS

BUILDING and MKCATPAGES

Luc van der Veen — 2012-11-08T00:22:19

Hi,

I noticed BUILDING says MKCATPAGES is set to yes by default, but UPDATING says 
it is set to no.