{"id":35015936,"url":"https://github.com/mdda/eeedora","last_synced_at":"2026-05-24T05:33:36.188Z","repository":{"id":28703010,"uuid":"32223437","full_name":"mdda/eeedora","owner":"mdda","description":" A Fedora distribution optimized for the Asus Eee PC ","archived":false,"fork":false,"pushed_at":"2015-03-16T16:58:05.000Z","size":60116,"stargazers_count":2,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-28T19:06:15.615Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mdda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-14T17:23:54.000Z","updated_at":"2024-04-01T06:24:55.000Z","dependencies_parsed_at":"2022-09-04T17:42:32.590Z","dependency_job_id":null,"html_url":"https://github.com/mdda/eeedora","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mdda/eeedora","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdda%2Feeedora","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdda%2Feeedora/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdda%2Feeedora/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdda%2Feeedora/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mdda","download_url":"https://codeload.github.com/mdda/eeedora/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdda%2Feeedora/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33423284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-27T05:19:51.517Z","updated_at":"2026-05-24T05:33:36.156Z","avatar_url":"https://github.com/mdda.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eeedora\n\n( Automatically migrated from code.google.com/p/eeedora )\n\nWhen the original Asus Eee 701 PC came out, it came with a nice-and-easy UI, on top of a Xandros (debian-based) core.\n\nHowever, for 'power users' familiar with RedHat distributions, it's far more comfortable to use a version of Fedora, customized for the Eee machine.\n\nThis project includes the files necessary to build a custom spin of Fedora (using their excellent tools), put it onto a CD (or USB key) as a Live version to test it out, and then install it as a replacement for the Asus default.\nGoals\n\nThis project's goal is to have a Live (and installable) distribution that :\n\n  * Is Fedora (currently Fedora 8)\n  * Runs XFCE as a windowing environment\n  * Takes as little space on the Eee's Flash drive as possible\n  * Gives the user the option of installing bigger packages (like openoffice, media players, etc)\n  * Understands each piece of hardware on the Eee (wireless, webcam, speakers, etc)\n  * ... and generally gives everyone a sense of satisfaction. \n\n## Documentation\n\nThere are a few more Wiki pages over at http://wiki.eeeuser.com/howto:eeedora , and there's a downloadable ISO available at http://eeedora.complexvalues.com/ .\n\n  * The current State of Play\n  * The Basic Approach taken with getting this spin working\n  * Notes on getting the wired internet to work\n  * Notes on creating a Live USB install \n\n## ... but it's an old project...\n\nThis is now somewhat obsolete, simply because the required updates were adopted into the mainline.\n\n\n\n\n## Where the EeeDora setup stands now\n\n### What it Does Do\n\n  * Boots Fedora 8 on a Live USB or Live CD, connected to the Eee PC USB ports\n  * Goes into a nice-looking XFCE windowing environment\n  * Includes a 1-click install to the Eee's internal drive\n     * Works for 4Gb and 2Gb Eee's\n  * Has kernel modules set up for :\n     * Wired ethernet (atl2)\n     * Wireless ethernet (Atheros)\n     * ACPI handling (Asus source code, plus scripts)\n     * Webcam (uvcvideo)\n     * truecrypt (for actual security)\n  * The ACPI lets the Blue Function keys work, as well as the external VGA switching\n  * ...\n\n### What it Doesn't Do (yet)\n\n  * Ultra-clean suspend/resume for the wifi\n  * Otherwise : Let me know\n  * ...\n\n### What it Doesn't Do Generally\n\n  * Include a lot of bloat (let the user choose what they need)\n  * Anything half as nice as the default Xandros UI\n  * Give any protection from Microsoft patent FUD (ouch!)\n\n\n## Creation of an Installable Live USB\n\n### Quick version \n\n  * Check out the SVN anonymously\n  * If you want to build a USB image, make sure the key is on `/dev/sdb1/`\n    * Obviously, I've taken a short-cut here\n  * Run `./build.eeedora.bash`\n  * This will build an ISO image of what you need\n    * and will optionally install it onto the USB key\n  * The RPM packages it uses get cached in a `yum_cache` directory\n    * this is a time-saver if you're making adjustments to the `.ks` file\n    * empty it out when you're done\n\n### Longer Version \n\nOver at http://wiki.eeeuser.com/eeedora:issues .\n\n\n## How this whole thing works\n\n### Introduction \n\nFedora includes a tool called kickstart that makes building distributions 'easy'.\n\nHowever, because this is entirely driven by RPMs, it's very difficult to get all the customization done in the kickstart file itself (since a 'round trip' takes about 45 minutes).\n\nAlso, since the Eee has non-standard drivers required for the wired ethernet (atl2) and wireless (Atheros), custom binaries also have to be 'shipped' within the ISO image.\n\nRather than face RPM version hell (since each user will probably be building this on slightly different kernel versions), I decided to take the easy way out :  Build a since RPM that contains a tar-ball of everything that's needed on the Eee itself.\n\n### The RPM : eee_tarball\n\nIn the `eee-setup` directory, there's a script that builds an RPM of scripts and settings, ready to be untarred in the /root/ directory.\n\nFrom there, it's a simple matter for the kickstart file to untar in tar-ball, and run scripts within it.  This makes for a very extensible system, and makes each 'round-trip' incrementally more worthwhile.\n\nThe build-eeedora.bash script creates a local repository for the _one_ RPM, and then builds the ISO for the whole system.  From there, everything is automatic.\n\n\n\n## How to compile up the atl2 driver\n\n### Introduction \n\nThere have been changes in the files `\u003clinux/etherdevice.h\u003e` and `\u003clinux/ethtool.h\u003e`, which stopped the ASUS/Atheros distributed `atl2-1.0.40.4.tar.gz` compiling and installing correctly.\n\nAfter some digging around with a kernel cross-reference tool (I only just found out these cool tools)...  Looks much better now.  I've uploaded the kernel module `atl2.ko` compiled for `2.6.23.1-49.fc8`.\n\n### Details - for updating a standard tar-ball\nInsert the following into the file `kcompat.h` just before the final `#endif` :\n\n```\n#if ( LINUX_VERSION_CODE \u003e= KERNEL_VERSION(2,6,23) )\n// this used to be in \u003clinux/etherdevice.h\u003e - disappeared in 2.6.23\n// See : http://lxr.free-electrons.com/diff/include/linux/etherdevice.h?v=2.6.22;diffval=2.6.23;diffvar=v\nstatic inline void eth_copy_and_sum (struct sk_buff *dest,\n        const unsigned char *src,\n        int len, int base)\n{\n memcpy (dest-\u003edata, src, len);\n}\n// this used to be in \u003clinux/ethtool.h\u003e - disappeared in 2.6.23\n//  static const struct ethtool_ops.get_perm_addr  = ethtool_op_get_perm_addr,\n// See : http://lxr.free-electrons.com/diff/include/linux/ethtool.h?v=2.6.22;diffval=2.6.23;diffvar=v\n#undef ETHTOOL_GPERMADDR\n#endif /* \u003e= 2.6.23 */\n```\n\n### Installing the module \nAs root :\n```\nmkdir /lib/modules/`uname -r`/kernel/drivers/net/atl2\ncp atl2.ko /lib/modules/`uname -r`/kernel/drivers/net/atl2/\n/sbin/depmod -a\n\n# Do this as a force since this was compiled against 2.6.23.1-49.fc8,\n# and your kernel may be different (should be no big deal, as long as it's Fedora 8)\n/sbin/modprobe -f atl2\n```\n\n### To Do ... \n   * Upload the full (updated) source ASAP\n   * Email the Atheros tech guy (xiong.huang 'at' atheros.com) to help him out\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdda%2Feeedora","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmdda%2Feeedora","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdda%2Feeedora/lists"}