{"id":13875872,"url":"https://github.com/rhboot/grubby","last_synced_at":"2025-07-16T10:32:02.827Z","repository":{"id":29077551,"uuid":"32605665","full_name":"rhboot/grubby","owner":"rhboot","description":"Retired; BLS-only support lives at https://src.fedoraproject.org/rpms/grubby","archived":true,"fork":false,"pushed_at":"2022-04-27T17:14:25.000Z","size":1600,"stargazers_count":31,"open_issues_count":0,"forks_count":28,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-10-11T00:47:21.153Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Roff","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rhboot.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-20T20:31:49.000Z","updated_at":"2024-08-06T08:06:58.000Z","dependencies_parsed_at":"2022-08-22T17:40:43.660Z","dependency_job_id":null,"html_url":"https://github.com/rhboot/grubby","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhboot%2Fgrubby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhboot%2Fgrubby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhboot%2Fgrubby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhboot%2Fgrubby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rhboot","download_url":"https://codeload.github.com/rhboot/grubby/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226122303,"owners_count":17576920,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-08-06T06:00:47.773Z","updated_at":"2024-11-24T03:31:27.973Z","avatar_url":"https://github.com/rhboot.png","language":"Roff","funding_links":[],"categories":["Roff","others"],"sub_categories":[],"readme":"This repo is retired\n====================\n\nWith the adoption of BLS, grubby has been largely superseded by a shell script\nthat lives downstream in Fedora.  This repo is no longer maintained.\n\ngrubby\n======\n\ngrubby is a command line tool for updating and displaying information about\nthe configuration files for the grub, lilo, elilo (ia64), yaboot (powerpc)\nand zipl (s390) boot loaders. It is primarily designed to be used from scripts\nwhich install new kernels and need to find information about the current boot\nenvironment.\n\n\nTesting grubby\n==============\n\nTo execute the integrated test suite from inside the source directory run the\ncommand::\n\n    make test\n\n\nTest Suite Architecture\n------------------------\n\ngrubby's test suite is written in Bash. The file `test.sh` contains several\nhelper functions and a list of different test scenarios which are exercised\nupon execution. Important functions are:\n\n- oneTest() - test if the configuration generated by the supplied grubby\n  parameters matches a well known configuration file;\n\n- oneDisplayTest() - test grubby features that display some information,\n  checking grubby's output against well known values;\n\n- commandTest() - test if the output of some commands matches the provided\n  text. This function is only used for grub2 testing in a few places.\n\n\nNote: the test suite creates aliases for oneTest() and oneDisplayTest(), which\nare prefixed with the corresponding boot loader name. For example:\ngrubTest(). eliloTest(), etc.\n\nThe invocation syntax is::\n\n    testFunction config_file results_file --grubby --options\n\nFor example the line::\n\n    grubTest grub.1 updargs/g1.1 --update-kernel=DEFAULT --args=\"root=/dev/hda1\"\n\nmeans execute the command::\n\n    ./grubby --grub --config-file tests/grub.1 --update-kernel=DEFAULT \\\n    --args=\"root=/dev/hda1\"\n\nand compare the resulting configuration with the file\n`tests/results/updargs/g1.1`.\n\n\nThe line::\n\n    grubDisplayTest grub.1 defaultindex/0 --default-index\n\nmeans execute::\n\n    ./grubby --grub --config-file tests/grub.1 --default-index\n\nand compare the output with the file `tests/results/defaultindex/0`.\n\nWriting New Test Cases\n----------------------\n\nTo write a new test case for grubby you need a config file which matches the\ninitial test conditions (either existing one or a new one), provide a\nresults file (likely a new one) which contains the expected configuration or\noutput and finally add a call to the test function(s) using the desired grubby\nparameters in an appropriate section of `test.sh`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhboot%2Fgrubby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frhboot%2Fgrubby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhboot%2Fgrubby/lists"}