abclinuxu.cz AbcLinuxu.cz itbiz.cz ITBiz.cz HDmag.cz HDmag.cz abcprace.cz AbcPráce.cz
Inzerujte na AbcPráce.cz od 950 Kč
Rozšířené hledání
×
    dnes 16:55 | Nová verze

    Vývojáři KDE oznámili vydání balíku aplikací KDE Gear 24.05. Přehled novinek i s náhledy a videi v oficiálním oznámení. Do balíku se dostalo 5 nových aplikací: Audex, Accessibility Inspector, Francis, Kalm a Skladnik.

    Ladislav Hagara | Komentářů: 0
    dnes 12:55 | Nová verze

    Byla vydána (𝕏) nová verze 18.0.0 open source webového aplikačního frameworku Angular (Wikipedie). Přehled novinek v příspěvku na blogu.

    Ladislav Hagara | Komentářů: 0
    včera 23:44 | Pozvánky

    V neděli 26. května lze navštívit Maker Faire Rychnov nad Kněžnou, festival plný workshopů, interaktivních činností a především nadšených a zvídavých lidí.

    Ladislav Hagara | Komentářů: 0
    včera 16:33 | Nová verze

    Byla vydána nová stabilní verze 3.20.0, tj. první z nové řady 3.20, minimalistické linuxové distribuce zaměřené na bezpečnost Alpine Linux (Wikipedie) postavené na standardní knihovně jazyka C musl libc a BusyBoxu. Z novinek lze vypíchnou počáteční podporu 64bitové architektury RISC-V.

    Ladislav Hagara | Komentářů: 0
    včera 14:11 | IT novinky

    Společnost Jolla na akci s názvem Jolla Love Day 2 - The Jolla comeback představila telefon se Sailfish OS 5.0 Jolla Community Phone (ve spolupráci se společností Reeder) a počítač Jolla Mind2 Community Edition AI Computer.

    Ladislav Hagara | Komentářů: 2
    včera 12:33 | Nová verze

    LibreOffice 24.8 bude vydán jako finální v srpnu 2024, přičemž LibreOffice 24.8 Alpha1 je první předběžnou verzí od začátku vývoje verze 24.8 v prosinci 2023. Od té doby bylo do úložiště kódu odesláno 4448 commitů a více než 667 chyb bylo v Bugzille nastaveno jako opravené. Nové funkce obsažené v této verzi LibreOffice najdete v poznámkách k vydání.

    ZCR | Komentářů: 0
    21.5. 23:33 | Nová verze

    Nová čísla časopisů od nakladatelství Raspberry Pi: MagPi 141 (pdf) a HackSpace 78 (pdf).

    Ladislav Hagara | Komentářů: 0
    21.5. 21:22 | Nová verze

    Byla vydána verze 2.0.0 programovacího jazyka Kotlin (Wikipedie, GitHub). Oficiálně bude představena ve čtvrtek na konferenci KotlinConf 2024 v Kodani. Livestream bude možné sledovat na YouTube.

    Ladislav Hagara | Komentářů: 2
    21.5. 12:55 | Nová verze

    Byla vydána nová major verze 27.0 programovacího jazyka Erlang (Wikipedie) a související platformy OTP (Open Telecom Platform, Wikipedie). Přehled novinek v příspěvku na blogu.

    Ladislav Hagara | Komentářů: 0
    21.5. 01:11 | Nová verze

    Byla vydána nová verze 1.8.0 svobodného multiplatformního softwaru pro konverzi video formátů HandBrake (Wikipedie). Přehled novinek v poznámkách k vydání na GitHubu. Instalovat lze také z Flathubu.

    Ladislav Hagara | Komentářů: 0
    Podle hypotézy Mrtvý Internet mj. tvoří většinu online interakcí boti.
     (82%)
     (4%)
     (7%)
     (7%)
    Celkem 503 hlasů
     Komentářů: 16, poslední 14.5. 11:05
    Rozcestník

    Občas není od věci vyslovit něco, za co se upaluje nebo ukamenovává. Nic není totiž tak jednoduché, aby byla pravda vždy jediná a na první pohled zřejmá.


    NAVRCHOLU.cz
    Aktuální zápisy

    The Kernel API Reference

    26.6.2006 21:32 | Přečteno: 1040× | Software | poslední úprava: 27.6.2006 21:30

    Nepříjemným problémem při vývoji nových ovladačů (a dalších věcí do jádra) pro Linux je chybějící referenční dokumentace API linuxového jádra. Nyní už je tu ale něco, co by mohlo v tomto ohledu pomoci.

    Možná si ještě někdo vzpomene, že jsem se tu zhruba před rokem ptal v diskusi, zda někde neexistuje referenční dokumentace API Linuxu. Dostal jsem tehdy pár podnětných odpovědí - jedna z nich vedla na skutečný pokus o takovou dokumentaci, ovšem pro jádra 2.4 a ještě v dost neúplné podobě. Mnohem důležitější se ale ukázal jiný nápad - generovat dokumentaci ze zdrojáků.

    Protože muset každou chvíli prolézat headery jádra jen kvůli tomu, abych věděl, jak volat nějakou funkci nebo jaké položky obsahuje nějaká struktura, je dost otravné, skutečně jsem tehdy skončil u toho, že jsem si pomocí programu Doxygen jakousi referenční dokumentaci API vygeneroval. Byla užitečná, nicméně tomu něco chybělo.

    To "něco" byly informace, co příslušná funkce nebo makro dělá, co znamenají jednotlivé argumenty, totéž pro struktury atd. Problém je, že headery takovými informacemi buď vůbec neoplývají, a když, tak hodně strohými. Ale i za tyto informace by byl člověk vděčný, ovšem v podobě, v jaké normálně jsou, je Doxygen nevstřebá.

    Postupem času jsem tedy vytvořil pravidla pro sed, která se na hlavičkové soubory aplikují, a komentáře u struktur a prototypů funkcí se jimi zpracují do použitelnější podoby. Pak už skutečně stačí spustit Doxygen a nechat si vygenerovat dokumentaci.

    Protože je jasné, že by výsledek tohoto snažení mohl být užitečný i pro další lidi, dávám ho nyní k dispozici na adrese www.kernel-api.org. Dokumentace je tam k dispozici pro všechna jádra řady 2.6, a pak vždy pro poslední jádra všech stabilních řad. Čistě pro zajímavost je tam též prapůvodní jádro 0.99.

    Dokumentaci lze prohlížet přímo online, anebo stáhnout v některém nabízeném formátu (GZIP, BZIP2, ZIP). Pozor ovšem, zejména u posledních verzí se jedná o balíky o řádové velikosti 40-70 MB.

    Je jasné, že vzniklá dokumentace je velice nedokonalá (tím spíš, že byla generována automaticky a nebylo v mých silách ani časových možnostech ji kontrolovat). Nabízím ji proto, že je v tuto chvíli aspoň něco a do budoucna se na tom dá dále pracovat. Samozřejmě uvítám jakékoli náměty a připomínky. Ještě připomínám (uvádím to i přímo u dokumentace), že to nemá být konkurence cross-referencí Linuxu - naopak, oba zdroje se dobře doplňují. Možná by to šlo v budoucnu sloučit, uvidí se.

    Takže kdo má zájem, nechť prohlíží a stahuje. Kdyby to někomu i jen sebenepatrněji pomohlo, má tento projekt smysl.

    UPDATE 27.6.2006: Zasláno do LKML - zde je přímý odkaz.


           

    Hodnocení: 100 %

            špatnédobré        

    Tiskni Sdílej: Linkuj Jaggni to Vybrali.sme.sk Google Del.icio.us Facebook

    Komentáře

    Vložit další komentář

    26.6.2006 22:06 Thunder.m | skóre: 35 | blog: e17
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    Teda, fakt hodně zajímavé!
    26.6.2006 22:15 Zdeněk Štěpánek | skóre: 57 | blog: uz_mam_taky_blog | varnsdorf
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    Nenapsal jsi o tom, tak nevim jestli neco v tehle veci uz nepodnikas.

    Myslim si, ze by bylo fajn to oznamit do LKML a navrhnout stadnard pro psani komentaru k funkcim, aby bylo z ceho cerpat zminene informace.

    Zdenek
    www.pirati.cz - s piráty do parlamentu i jinam www.gavanet.org - czfree varnsdorf
    Luk avatar 26.6.2006 22:40 Luk | skóre: 47 | blog: Kacířské myšlenky | Kutná Hora
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    V tomto jsem zatím nepodnikl vůbec nic, i když s tím počítám, a to co nejdřív.

    Jen u toho psaní komentářů jsem docela skeptický. Je to bohužel tak, že většina vývojářů (nejen jádra) je píše dost nerada. Ale třeba by se někteří nechali přesvědčit ;-)
    Šifrování je absolutní nutnost a pomáhá chránit před nekalými živly
    27.6.2006 10:36 Robert Krátký | skóre: 94 | blog: Robertův bloček
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    V tomto jsem zatím nepodnikl vůbec nic, i když s tím počítám, a to co nejdřív.
    Hodíš sem pak link na to vlákno?
    Luk avatar 27.6.2006 21:30 Luk | skóre: 47 | blog: Kacířské myšlenky | Kutná Hora
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    Je to tam ;-)
    Šifrování je absolutní nutnost a pomáhá chránit před nekalými živly
    26.6.2006 22:18 Marián André | skóre: 10 | blog: Qblog
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    K tomuto by som si dovolil doplniť odkaz na vznikajúci Linux Device Driver Kit.
    Nikola Ciprich avatar 27.6.2006 11:54 Nikola Ciprich | skóre: 23 | blog: NiX_blog | Palkovice
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    super!

    ohledne psani komentaru vyvojari bych nebyl takovy skepticky - myslim ze tento projekt ma potencial ukazat jejich uzitecnost, a staci kdyz to udela dojem na Linuse aby trosku updatoval Documentation/CodingStyle ;-)

    respect!
    Did you ever touch the starlight ? Dream for a thousand years? Have you ever seen the beauty Of a newborn century?
    Bluebear avatar 27.6.2006 13:11 Bluebear | skóre: 30 | blog: Bluebearův samožerblog | Praha
    Rozbalit Rozbalit vše Re: The Kernel API Reference
    Aleluja! Tohle bylo uz dlouho potreba, diky ti!
    To mi připomíná, jak jsem si pořídil květináč, že v něm budu mít květinu. Opravdu tam byla, ale potom být přestala...

    Založit nové vláknoNahoru

    ISSN 1214-1267   www.czech-server.cz
    © 1999-2015 Nitemedia s. r. o. Všechna práva vyhrazena.