{"id":22555468,"url":"https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter","last_synced_at":"2025-04-04T15:06:09.828Z","repository":{"id":37079441,"uuid":"155736730","full_name":"eclipse-cdt-cloud/cdt-gdb-adapter","owner":"eclipse-cdt-cloud","description":"CDT GDB Debug Adapter","archived":false,"fork":false,"pushed_at":"2025-02-10T17:12:26.000Z","size":1116,"stargazers_count":33,"open_issues_count":33,"forks_count":43,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-03-28T14:04:44.012Z","etag":null,"topics":["cdt","debug","gdb"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipse-cdt-cloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-01T15:33:11.000Z","updated_at":"2025-02-27T06:11:39.000Z","dependencies_parsed_at":"2023-02-15T21:15:19.168Z","dependency_job_id":"afba0fb7-1fe7-4558-914a-10c4984a292f","html_url":"https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter","commit_stats":null,"previous_names":["eclipse-cdt/cdt-gdb-adapter"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fcdt-gdb-adapter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fcdt-gdb-adapter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fcdt-gdb-adapter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fcdt-gdb-adapter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipse-cdt-cloud","download_url":"https://codeload.github.com/eclipse-cdt-cloud/cdt-gdb-adapter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198439,"owners_count":20900079,"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":["cdt","debug","gdb"],"created_at":"2024-12-07T19:07:57.930Z","updated_at":"2025-04-04T15:06:09.809Z","avatar_url":"https://github.com/eclipse-cdt-cloud.png","language":"TypeScript","readme":"# CDT GDB Debug Adapter\n\nThis is an implementation of the Debug Adapter Protocol for gdb.\nIt is loosely based on the Eclipse CDT MI layer.\nWe are at least learning from it.\n\nThe source code can be found in the following repository: https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter\n\n## Building\n\nBuild is pretty simple.\n\n```sh\nyarn\n```\n\n## Running\n\nThe entry point for the adapter is `cdtDebugAdapter` for local debugging\nand `cdtDebugTargetAdapter` for target (remote) debugging.\n\n### Command line arguments\n\n#### `--server=PORT`\n\nStart the adapter listening on the given port instead of on stdin/stdout.\n\n#### `--config=INITIALCONFIG`\n\nStart the adapter using the given configuration as a starting point for the args in `launch` or `attach` request.\n\nFor example, the default GDB can be set like this:\n\n```sh\n    node debugTargetAdapter.js --config='{\"gdb\":\"arm-none-eabi-gdb\"}'\n```\n\nThe config can be passed on the command line as JSON, or a response file can be used by starting the argument with `@`.\nThe rest of the argument will be interpreted as a file name to read.\nFor example, to start the adapter defaulting to a process ID to attach to, create a file containing the JSON and reference it like this:\n\n```sh\n    cat \u003econfig.json \u003c\u003cEND\n    {\n      \"processId\": 1234\n    }\n    END\n    node debugAdapter.js --config=@config.json\n\n```\n\n#### `--config-frozen=FROZENCONFIG`\n\nSimilar to `--config`, the `--config-frozen` sets the provided configuration fields in the args to the `launch` or `attach` request to the given values, not allowing the user to override them.\nSpecifying which type of request is allowed (`launch` or `attach`) can be specified with the `request` field.\nWhen freezing the type of request, regardless of which type of request the user requested, the frozen request type will be used.\n\nFor example, the adapter can be configured for program to be frozen to a specific value.\nThis may be useful for starting adapters in a container and exposing the server port.\n\n```sh\n    node debugAdapter.js --server=23221 --config-frozen='{\"program\":\"/path/to/my.elf\"}'\n```\n\n## Testing\n\nTesting of the adapter can be run with `yarn test`. See [Integration Tests readme](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/integration-tests/README.md)\nfor more details, including how to setup a Windows machine with msys2 to run the tests.\n\n## Testing on GitHub Actions\n\nPull Requests built using GitHub actions.\nIn the GitHub actions result you can examine test report and download the `test-logs` artifacts which are the verbose logs of each test that was run.\nSee [Integration Tests readme](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/blob/main/src/integration-tests/README.md) for more details\n\n## Debugging\n\nTo debug the adapter there are multiple options depending on how this module is integrated. For example,\nif being used as a VS Code extension, see https://github.com/eclipse-cdt-cloud/cdt-gdb-vscode#building.\n\nHowever, if you are writing tests and developing this module independently you can use the launch\nconfigurations in the launch.json with VS Code. For example, if you open a \\*.spec.ts file in VS Code\nyou can use the \"Mocha Current File \u0026 launch Server\" configuration to automatically launch the debug\nserver in one debugged process and the test in another.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-cdt-cloud%2Fcdt-gdb-adapter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipse-cdt-cloud%2Fcdt-gdb-adapter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-cdt-cloud%2Fcdt-gdb-adapter/lists"}