[OpenBSD]

[FAQ Index] [Do sekce 1 - Seznámení s OpenBSD] [Do sekce 3 - Jak získat OpenBSD]

2 - Jiné zdroje informací o OpenBSD

Obsah


2.1 - Zajímavé webové stránky

Oficiální stránka OpenBSD projektu se nachází zde: http://www.OpenBSD.org.

Zde je množství cenných informací týkajících se OpenBSD.

Informace pro uživatele laptopů najdete na:
http://www.monkey.org/openbsd-mobile/.

2.2 - Konference

OpenBSD projekt udržuje několik populárních mailových konferencí, do kterých se mohou uživatelé přihlásit a číst je. Pro přihlášení do těchto konferencí zašlete e-mail na majordomo@openbsd.org. Adresa je směrována na automatický přihlašovací systém. V těle dopisu by jste měli na zvláštní řádek napsat příkaz "subscribe" a k němu ještě název konference do které se chcete přihlásit. Například:

subscribe announce

Po krátké době vám přijde odpověď od systému konference, požadující ověření vašeho příkazu, proto aby vás někdo jiný nemohl přihlásit proti vaší vůli a zahltit vás nevyžádánými e-maily. Zpráva, kterou dostanete bude obsahovat instrukce pro přihlášení do konference, buďto webový odkaz do systému konference, nebo zaslání potvrzovací zprávy, nebo zaslání potvrzení na majordomo@openbsd.org. Použijete tu metodu, která vám bude lépe vyhovovat. Všimněte si, že každá ze tří technik přihlášení s sebou nese unikátní a časově limitování identifikační číslo, jako je např. A56D-70D4-52C3, což je opět z toho důvodu, aby bylo prověřeno, že vy jste tím, kdo požádal o přihlášení do konference.

Jakmile ověříte váš záměr připojit se do konference, budete bezprostředně přidáni do seznamu účastníků konference a systém vám v dalším e-mailu oznámí, že jste byli úspěšně přidáni.

Chcete-li se odhlásit z konference, musíte opět odeslat e-mail na majordomo@openbsd.org. Měl by vypadat asi takhle:

unsubscribe announce

Máte-li problémy se systémem konference, přečtěte si prosím nejprve instrukce. Můžete je obdržet odesláním e-mailové zprávy na majordomo@openbsd.org s tělem zprávy např. "help".

Vaše přihlášení do OpenBSD konferencí můžete spravovat prostřednictvím webového rozhraní na http://lists.openbsd.org

Následuje výčet populárních konferencí OpenBSD:

Předtím než pošlete otázku do misc nebo do jiné konference, prosíme zkontrolujte archívy, protože mnoho běžných otázek je kladeno opakovaně. Zatímco vy jste narazili na problém poprvé, ostatní v konferenci mohli tu samou otázku vidět už několikrát za poslední týden a nechtějí ji už znovu řešit.

Celou řadu archívu konference, další instrukce ohledně OpenBSD konferencí a další informace najdete na stránce týkající se e-mailových konferencí.

Jiná mailová konference, která vás může zajímat je openbsd-mobile@monkey.org, kde se diskutuje o použití OpenBSD na přenosných zařízeních.

Pro přihlášení do této konference použijte:

'echo subscribe | mail "openbsd-mobile-request@monkey.org"'

Její archív se nachází zde: http://www.monkey.org/openbsd-mobile/archive/.

2.3 - Manuálové stránky

OpenBSD přichází s rozsáhlou a podrobnou dokumentací ve formě manuálových stránek, stejně tak jako s dokumenty týkajícími se specifických aplikací. Pro přístup k manuálovým stránkám a jiné dokumentaci se ujistěte, že máte nainstalované distribuce man a misc.

Zde je seznam nejužitečnějších manuálových stránek pro nové uživatele:

Všechny manuálové stránky OpenBSD můžete najít na webu na adrese http://www.openbsd.org/cgi-bin/man.cgi, stejně jako ve vašem počítači, pokud jste si nainstalovali set man34.tgz.

Obecně, pokud znáte název příkazu nebo manuálové stránky, která se k němu váže, můžete si ji přečíst vykonáním příkazu "man příkaz". Například: "man vi" pro informace o editoru vi. Pokud neznáte jméno příkazu, nebo pokud příkaz "man příkaz" nenajde manuálovou stránku, můžete hledat manuálovou stránku v databázi pomocí "apropos něco" nebo "man -k něco" kde něco je slovo, které je patrně součástí názvu manuálové stránky, kterou hledáte. Například:

# apropos "time zone"
tzfile (5) - time zone information
zdump (8) - time zone dumper
zic (8) - time zone compiler

Pro české čtenáře jen doplním, že překlad manuálových stránek do češtiny neexistuje, dokonce na něm pokud vím ani nikdo nepracuje a popravdě řečeno by to byl heroický výkon, vezmeme-li v úvahu, že manuálové stránky nemají lokalizované ani Němci, Francouzi ani Rusové.

Čísla v závorkách značí číslo sekce manuálu, ve které se stránka nalézá. V některých případech můžete nalézt manuálové stránky se stejnými názvy v různých sekcích manuálu. Například předpokládejme, že chcete znát formát konfiguračních souborů pro démona cron. Jakmile jednou víte, kterou sekci manuálových stránek požadujete, můžete vykonat příkaz "man n příkaz" kde n je číslo sekce manuálových stránek.

# man -k cron
cron (8) - clock daemon
crontab (1) - maintain crontab files for individual users
crontab (5) - tables for driving cron
# man 5 crontab

Kromě manuálových stránek je k dispozici i dokumentace vhodná pro tisk na tiskárně, (obsažena v instalačním souborovém setu misc34.tgz). Nachází se v adresáři /usr/share/doc. Každý z dokumentů v tomto adresáři můžete zformátovat spuštěním příkazu v odpovídajícím podadresáři. Podadresář psd je dokumentace "Programmer's Supplementary Documents". Podadresář smm obsahuje "System Manager's Manual". Poadresář usd náleží dokumentaci "UNIX User's Supplementary Documents". Můžete spustit příkaz "make" v každém z těchto podadresářů, nebo si můžete vybrat jen určitý podadresář distribuce náležející jedné z sekcí a v ní 'make' spustit. Některé z adresářů jsou prázdné. Bez parametrů spuštěný 'make' bude formátovat dokumentaci do Postscriptu, vhodnému pro tisk. Výstup v Postscriptu je poněkud náročnější na místo na disku, proto předpokládejte asi 250-300%-ní zvetšení objemu distribuce na disku. Nemáte-li přístup k postscriptové tiskárně, popřípadě displeji, na kterém byste mohli dokumentaci zobrazit, můžete rovněž naformátovat dokumentaci pro čtení na textovém terminálu. V každém ze souborů pro příkaz 'make' s názvem Makefile musíte v každém výskytu formátovacího příkazu groff(1) přidat jako jeho parametr přepínač "-Tascii" (nebo můžete formátovací příkazy vykonat ručně). Některé z dokumentů užívají formátovací makra ms a některé zase makra me. Makefile v odpovídajícím podadresáři (např. /usr/share/doc/usd/04.csh/Makefile) vám napoví, které z maker použít. Například:

# cd /usr/share/doc/usd/04.csh
# groff -Tascii -ms tabs csh.1 csh.2 csh.3 csh.4 csh.a csh.g > csh.txt
# more csh.txt

UNIXové manuálové stránky jsou obecně aktuálnější a bližší současné realitě než tisknutelné dokumenty. Tisknutelné dokumenty však někdy vysvětlují komplikované aplikace detailněji než manuálové stránky.

Pro mnohé z vás může být užitečné mít také manuálové stánky vytištěné na papíře. Zde je návod jak vyrobit tisknutelnou kopii manuálové stránky.

Jak zobrazit zdrojový soubor odpovídající manuálové stránky? (tedy např. soubor, jehož jméno končí číslem, jako tcpdump.8).

Tyto soubory se nacházejí v celém stromu 'src'. Manuálové stránky se zde nacházejí nenaformátované a za pomocí CVS mohou být ty ve stromě 'src' aktualizovány. Pro prohlížení těchto stránek spusťte jednoduše příkaz:

# nroff -mandoc <file> | more

Jak získám manuálovou stránky bez formátovacích nebo jakýchkoliv kontrolních znaků?

Následující postup je vhodný, pokud chceme získat manuálovou stránku přímo, bez formátovacích znaků.
Příklad:

# man <command> | col -b

Jak mohu získat Postscriptovou kopii manuálové stránky, vhodnou pro tisk?

Poznamenejme, že [man_src_file] musí být zdrojový text manuálové stránky (pravděpodobně soubor, jehož jméno končí číslem; jako tcpdump.8). Postscriptová verze manuálových stránek vypadá velmi pěkně. Může být prohlížena na obrazovce programem jako je např. gv (GhostView). GhostView můžete nalézt v stromu portů. Použijte groff(1), aby jste dostali manuálovou stránku OpenBSD ve formátu PostScript:

# groff -mandoc -Tps [man_src_file] > outfile.ps

2.4 - Informování o chybách

Předtím než odešlete jakoukoliv takovou zprávu, přečtěte si prosím http://www.openbsd.org/cs/report.html.

Náležité informování o chybách v programech (bugs) je jednou z nejdůležitějších povinností uživatele. Velmi detailní informace jsou požadovány v případě kdy je nutno rozluštit velmi závažné chyby. Vývojáři dostávají často tyto hlášení prostřednictvím e-mailu jako je například tento:

From: někdo@někde.cz
To: bugs@openbsd.org
Subject: POMOC!!! w8

Mám PC, 486-ka a vůbec se mi nedaří ho nabootovat!!!!!!

Snad většina lidí chápe, proč jsou podobné zprávy bez ostychu mazány. Všechny zprávy o chybách v programech musí obsahovat detailní informace. Jestli uživatel 'někdo' skutečně očekává, že se bude jeho případem některý z vývojářů zabývat, bude muset dodat více informací... např. nějak takhle:

From: smartuser@example.com
To: bugs@openbsd.org
Subject:  3.3-beta panics on a SparcStation2 

OpenBSD 3.2 installed from an official CD-ROM installed and ran fine
on this machine.

After doing a clean install of 3.3-beta from an FTP mirror, I find the
system randomly panics after a period of use, and predictably and
quickly when starting X.

This is the dmesg output:

OpenBSD 3.3-beta (GENERIC) #9: Mon Mar 17 12:37:18 MST 2003
    deraadt@sparc.openbsd.org:/usr/src/sys/arch/sparc/compile/GENERIC
real mem = 67002368
avail mem = 59125760
using 200 buffers containing 3346432 bytes of memory
bootpath: /sbus@1,f8000000/esp@0,800000/sd@1,0
mainbus0 (root): SUNW,Sun 4/75
cpu0 at mainbus0: CY7C601 @ 40 MHz, TMS390C602A FPU; cache chip bug
- trap page uncached
cpu0: 64K byte write-through, 32 bytes/line, hw flush cache enabled
memreg0 at mainbus0 ioaddr 0xf4000000
clock0 at mainbus0 ioaddr 0xf2000000: mk48t02 (eeprom)
timer0 at mainbus0 ioaddr 0xf3000000 delay constant 17
auxreg0 at mainbus0 ioaddr 0xf7400003
zs0 at mainbus0 ioaddr 0xf1000000 pri 12, softpri 6
zstty0 at zs0 channel 0 (console i/o)
zstty1 at zs0 channel 1
zs1 at mainbus0 ioaddr 0xf0000000 pri 12, softpri 6
zskbd0 at zs1 channel 0: reset timeout
zskbd0: no keyboard
zstty2 at zs1 channel 1: mouse
audioamd0 at mainbus0 ioaddr 0xf7201000 pri 13, softpri 4
audio0 at audioamd0
sbus0 at mainbus0 ioaddr 0xf8000000: clock = 20 MHz
dma0 at sbus0 slot 0 offset 0x400000: rev 1+
esp0 at sbus0 slot 0 offset 0x800000 pri 3: ESP100A, 25MHz, SCSI ID 7
scsibus0 at esp0: 8 targets
sd0 at scsibus0 targ 1 lun 0: <SEAGATE, ST1480 SUN0424, 8628> SCSI2 0/direct fixed
sd0: 411MB, 1476 cyl, 9 head, 63 sec, 512 bytes/sec, 843284 sec total
sd1 at scsibus0 targ 3 lun 0: <COMPAQPC, DCAS-32160, S65A> SCSI2 0/direct fixed
sd1: 2006MB, 8188 cyl, 3 head, 167 sec, 512 bytes/sec, 4110000 sec total
le0 at sbus0 slot 0 offset 0xc00000 pri 5: address 08:00:20:13:10:b9
le0: 16 receive buffers, 4 transmit buffers
cgsix0 at sbus0 slot 1 offset 0x0: SUNW,501-2325, 1152x900, rev 11
wsdisplay0 at cgsix0
wsdisplay0: screen 0 added (std, sun emulation)
fdc0 at mainbus0 ioaddr 0xf7200000 pri 11, softpri 4: chip 82072
fd0 at fdc0 drive 0: 1.44MB 80 cyl, 2 head, 18 sec
root on sd0a
rootdev=0x700 rrootdev=0x1100 rawdev=0x1102


This is the panic I got when attempting to start X:

panic: pool_get(mclpl): free list modified: magic=78746572; page 0xfaa93000;
 item addr 0xfaa93000
Stopped at      Debugger+0x4:   jmpl            [%o7 + 0x8], %g0
RUN AT LEAST 'trace' AND 'ps' AND INCLUDE OUTPUT WHEN REPORTING THIS PANIC!
DO NOT EVEN BOTHER REPORTING THIS WITHOUT INCLUDING THAT INFORMATION!
ddb> trace
pool_get(0xfaa93000, 0x22, 0x0, 0x1000, 0x102, 0x0) at pool_get+0x2c0
sosend(0x16, 0xf828d800, 0x0, 0xf83b0900, 0x0, 0x0) at sosend+0x608
soo_write(0xfac0bf50, 0xfac0bf70, 0xfac9be28, 0xfab93190, 0xf8078f24, 0x0)
at soo_write+0x18
dofilewritev(0x0, 0xc, 0xfac0bf50, 0xf7fff198, 0x1, 0xfac0bf70) at
dofilewritev+0x12c
sys_writev(0xfac87508, 0xfac9bf28, 0xfac9bf20, 0xf80765c8, 0x1000, 0xfac0bf70)
at sys_writev+0x50
syscall(0x79, 0xfac9bfb0, 0x0, 0x154, 0xfcffffff, 0xf829dea0) at syscall+0x220
slowtrap(0xc, 0xf7fff198, 0x1, 0x154, 0x1, 0xfac87508) at slowtrap+0x1d8
ddb> ps
   PID   PPID   PGRP    UID  S       FLAGS  WAIT       COMMAND
 27765   8819  29550      0  3        0x86  netio      xconsole
  1668  29550  29550      0  3      0x4086  poll       fvwm
 15447  29550  29550      0  3     0x44186  poll       xterm
  8819  29550  29550     35  3      0x4186  poll       xconsole
  1238  29550  29550      0  3      0x4086  poll       xclock
 29550  25616  29550      0  3      0x4086  pause      sh
  1024  25523  25523      0  3     0x40184  netio      XFree86
*25523  25616  25523     35  2     0x44104             XFree86
 25616  30876  30876      0  3      0x4086  wait       xinit
 30876  16977  30876      0  3      0x4086  pause      sh
 16977      1  16977      0  3      0x4086  ttyin      csh
  5360      1   5360      0  3        0x84  select     cron
 14701      1  14701      0  3     0x40184  select     sendmail
 12617      1  12617      0  3        0x84  select     sshd
 27515      1  27515      0  3       0x184  select     inetd
  1904      1   1904      0  2        0x84             syslogd
  9125      1   9125      0  3        0x84  poll       dhclient
     7      0      0      0  3    0x100204  crypto_wa  crypto
     6      0      0      0  3    0x100204  aiodoned   aiodoned
     5      0      0      0  3    0x100204  syncer     update
     4      0      0      0  3    0x100204  cleaner    cleaner
     3      0      0      0  3    0x100204  reaper     reaper
     2      0      0      0  3    0x100204  pgdaemon   pagedaemon
     1      0      1      0  3      0x4084  wait       init
     0     -1      0      0  3     0x80204  scheduler  swapper

 Thank you!

Další informace o vytváření a zasílání zpráv o chybě najdete na stránce report.html. Pokud máte pocit, že váš problém může nějak souviset s hardwarem, pak je zapotřebí, abyste poskytli detailní informace o tomto hardware a o celkové hardwarové konfiguraci. Obvykle stačí výstup z programu dmesg(8). Samozřejmě je zapotřebí také, abyste poskytli detailní popis vašeho problému. V příkladu výše jste si mohli všimnout, že dmesg popsalo hardware, v textu uživatel popsal, proč se domnívá, že systém je v pořádku (běžela zde verze 3.2 se všemi opravami). Dále také popsal, jak byl pád systému způsoben (spustil X) a rovněž dodal výstup z ddb debuggeru, tj. výstup příkazů "ps" a "trace". V tomto případě uživatel dodal výstup, který zachytil na sériové konzoli; pokud nemáte tu možnost, pak použijte tužku a papír pro zaznamenání tohoto výstupu. (Příklad uvedený výše popisoval reálný problém, který se skutečně vyskytl a informace poskytnutá výše byla postačující k tomu, aby mohl být problém, postihující platformu Sun4c, opraven.)

Pokud máte funkční OpenBSD, z něhož chcete odeslat zprávu o chybě, měli byste použít utilitu sendbug(1) pro odeslání chybové zprávy systému pro sledování problému GNATS. Zřejmě nemůžete použít sendbug(1) v případě, že váš systém ani nenastartoval. Jinak byste však tento příkaz měli použít vždy, kdy je to možné. Budete muset do zprávy přidat detailní informaci o tom, co se stalo, přesné nastavení systému a nějak zprostředkovat daný problém. Příkaz sendbug(1) požaduje, aby váš systém byl správně nakonfigurován pro odesílání elektronické pošty přes Internet.

Po odeslání bug reportu přes sendbug(1) budete kontaktováni e-mailem o stavu vašeho reportu. Můžete být také kontaktováni vývojáři, pokud bude potřeba více informací nebo pro otestování oprav. Můžete také kontrolovat archív konference bugs@openbsd.org. Detaily najdete na stránce s mailing listy, nebo se můžete dotázat databáze problémů přímo za použití systému sledování chyb.

[FAQ Index] [Do sekce 1 - Seznámení s OpenBSD] [Do sekce 3 - Jak získat OpenBSD]


[zpět] www@openbsd.org
Originally [OpenBSD: faq2.html,v 1.67 ]
$Translation: faq2.html,v 1.20 2004/01/11 21:41:15 certik Exp $
$OpenBSD: faq2.html,v 1.19 2004/01/16 20:30:20 jufi Exp $