apt-ostree/DBUS-TEST-QUICK-REFERENCE.md
robojerk 97a9c40d7e docs: Add comprehensive documentation and update planning
- Add docs/README.md with project overview and current status
- Add docs/architecture.md with detailed architecture documentation
- Add docs/development.md with development guide for contributors
- Update .notes/todo.md to reflect architecture fix completion
- Update .notes/plan.md with completed phases and next priorities

Architecture fixes (daemon and dbus), bubblewrap integration are now complete.
Ready for OCI integration phase.
2025-07-18 23:38:57 +00:00

2.5 KiB

apt-ostree D-Bus Testing - Quick Reference

Essential Commands

1. Check Daemon Status

systemctl status apt-ostreed.service

2. List D-Bus Services

gdbus list --system | grep aptostree

3. Test D-Bus Introspection

gdbus introspect --system --dest org.aptostree.dev --object-path /org/aptostree/dev

4. Test Ping Method

gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.Ping

5. Test GetStatus Method

gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.GetStatus

6. Test Client-Daemon Communication

apt-ostree daemon-ping
apt-ostree daemon-status

Quick Test Script

Run the manual test script:

chmod +x test-dbus-manual.sh
sudo ./test-dbus-manual.sh

Troubleshooting Commands

Check Daemon Logs

journalctl -u apt-ostreed.service --no-pager -n 20

Restart Daemon

sudo systemctl restart apt-ostreed.service

Check D-Bus Configuration

ls -la /etc/dbus-1/system.d/org.aptostree.dev.conf
ls -la /usr/share/dbus-1/system-services/org.aptostree.dev.service

Reload D-Bus

sudo systemctl reload dbus

Test with Authentication

pkexec gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.Ping

Expected Results

Successful D-Bus Communication

  • Daemon service: active (running)
  • D-Bus service: org.aptostree.dev in list
  • Ping response: ('pong',)
  • Client ping: Daemon is responding: pong

Common Error Messages

  • Service not found: Daemon not running or D-Bus service not registered
  • Permission denied: Authentication/authorization issue
  • Connection refused: D-Bus configuration problem
  • Method not found: Interface mismatch

Quick Fixes

If Daemon Not Running

sudo systemctl start apt-ostreed.service
sudo systemctl enable apt-ostreed.service

If D-Bus Service Not Registered

sudo systemctl restart apt-ostreed.service
sudo systemctl reload dbus

If Permission Denied

# Check Polkit policy
ls -la /usr/share/polkit-1/actions/org.aptostree.dev.policy

# Test with authentication
pkexec gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.Ping

If Configuration Missing

# Reinstall daemon components
sudo ./scripts/install-daemon.sh