System subjects

This page describes Liberator system subjects that StreamLink clients can subscribe to.

Contents:

/SYSTEM/NOTIFY/STATE

/SYSTEM/NOTIFY/STATE

The operational state of the Liberator. StreamLink clients can subscribe to this subject to be alerted when a graceful shutdown is initiated on the Liberator they are connected to. This gives the clients an opportunity to transfer their connection to another Liberator.

The subject has three fields: state, info, and message.

Normal operation
Field	Value
`state`	"Operational"
`info`
`message`

Graceful shutdown scheduled (from Liberator 7.1.5)
Field	Value
`state`	"Shutdown scheduled"
`info`	The date and time when the grace-period starts. Format: `yyyy-mm-ddThh:mm:ss`
`message`	A message, set by the system administrator, describing the reason for the graceful shutdown.

Graceful shutdown initiated
Field	Value
`state`	"Shutting down"
`info`	The date and time when the grace-period ends. Format: `yyyy-mm-ddThh:mm:ss`
`message`	A message, set by the system administrator, describing the reason for the graceful shutdown.

For information on how a system administrator can initiate a graceful shutdown, see Liberator UDP commands.