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

    V Brestu dnes začala konference vývojářů a uživatelů linuxové distribuce Debian DebConf25. Na programu je řada zajímavých přednášek. Sledovat je lze online.

    Ladislav Hagara | Komentářů: 0
    dnes 11:33 | IT novinky

    Před 30 lety, tj. 14. července 1995, se začala používat přípona .mp3 pro soubory s hudbou komprimovanou pomocí MPEG-2 Audio Layer 3.

    Ladislav Hagara | Komentářů: 12
    dnes 10:55 | IT novinky

    Výroba 8bitových domácích počítačů Commodore 64 byla ukončena v dubnu 1994. Po více než 30 letech byl představen nový oficiální Commodore 64 Ultimate (YouTube). S deskou postavenou na FPGA. Ve 3 edicích v ceně od 299 dolarů a plánovaným dodáním v říjnu a listopadu letošního roku.

    Ladislav Hagara | Komentářů: 15
    včera 17:55 | Zajímavý projekt

    Společnost Hugging Face ve spolupráci se společností Pollen Robotics představila open source robota Reachy Mini (YouTube). Předobjednat lze lite verzi za 299 dolarů a wireless verzi s Raspberry Pi 5 za 449 dolarů.

    Ladislav Hagara | Komentářů: 11
    11.7. 16:44 | Komunita

    Dnes v 17:30 bude oficiálně vydána open source počítačová hra DOGWALK vytvořena v 3D softwaru Blender a herním enginu Godot. Release party proběhne na YouTube od 17:00.

    Ladislav Hagara | Komentářů: 3
    11.7. 14:55 | Humor

    McDonald's se spojil se společností Paradox a pracovníky nabírá také pomocí AI řešení s virtuální asistentkou Olivii běžící na webu McHire. Ian Carroll a Sam Curry se na toto AI řešení blíže podívali a opravdu je překvapilo, že se mohli přihlásit pomocí jména 123456 a hesla 123456 a získat přístup k údajům o 64 milionech uchazečů o práci.

    Ladislav Hagara | Komentářů: 16
    11.7. 00:11 | Nová verze

    Byla vydána (𝕏) červnová aktualizace aneb nová verze 1.102 editoru zdrojových kódů Visual Studio Code (Wikipedie). Přehled novinek i s náhledy a videi v poznámkách k vydání. Ve verzi 1.102 vyjde také VSCodium, tj. komunitní sestavení Visual Studia Code bez telemetrie a licenčních podmínek Microsoftu.

    Ladislav Hagara | Komentářů: 0
    10.7. 21:00 | Bezpečnostní upozornění

    Byla vydána nová verze 2.4.64 svobodného multiplatformního webového serveru Apache (httpd). Řešeno je mimo jiné 8 bezpečnostních chyb.

    Ladislav Hagara | Komentářů: 4
    10.7. 15:22 | Nová verze

    Společnost xAI na síti 𝕏 představila Grok 4, tj. novou verzi svého AI LLM modelu Grok.

    Ladislav Hagara | Komentářů: 12
    10.7. 12:55 | Bezpečnostní upozornění

    Ministerstvo vnitra odhalilo závažný kyberincident v IT systému resortu. Systém, do kterého se dostal útočník bez oprávnění, byl odpojen a nedošlo k odcizení dat [𝕏].

    Ladislav Hagara | Komentářů: 16
    Jaký je váš oblíbený skriptovací jazyk?
     (59%)
     (27%)
     (7%)
     (3%)
     (1%)
     (1%)
     (4%)
    Celkem 391 hlasů
     Komentářů: 16, poslední 8.6. 21: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
    Kategorie zápisků
    Aktuální zápisy

    Nejčtenější za poslední měsíc Nejkomentovanější za poslední měsíc

    The Kernel API Reference

    26.6.2006 21:32 | Přečteno: 1097× | 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.