description: Manages launch daemons running on the system
internal: false

aliases:
  - service
  - systemctl
  - rc-service

manual:
  summary: |
    This command starts, stops, gets the status and restarts launch daemons on the system.

  parameters:
    - name: Start
      description: Start a launch daemon
      required: false

    - name: Stop
      description: Stop a launch daemon
      required: false

    - name: ForceStop
      description: Force-stop a launch daemon, having it exit immediately without finishing properly
      required: false

    - name: Restart
      description: Restart a launch daemon
      required: false

    - name: Status
      description: Show the status of a launch daemon
      required: false

  final:
    name: LaunchDaemon
    description: The launch daemon to manage
    required: false
    multiple: false
    command: false
    path: false
    daemon: true

  examples:
    - command: CoreDaemon -Restart Something
      description: Restarts the launch daemon named Something

    - command: CoreDaemon -ForceStop HangingThing
      description: Forces the launch daemon named HangingThing to stop

    - command: CoreDaemon -Status
      description: Shows the status of all launch daemons on the system

  compatibility:
    mistyos: '>=1.2.0'
    kernel: '>=5.10.0'