to just after the first non-listed track before it, or to the head if there is
no such track.
.TP
+.B new \fR[\fIMAX\fR]
+Sends the most recently added \fIMAX\fR tracks in a response body. If the
+argument is ommitted, all recently added tracks are listed.
+.TP
+.B nop
+Do nothing. Used by
+.BR disobedience (1)
+as a keepalive measure.
+.TP
.B part \fITRACK\fR \fICONTEXT\fI \fIPART\fR
Get a track name part. Returns an empty string if a name part cannot be
constructed.
Unset a global preference.
.TP
.B user \fIUSER\fR \fIRESPONSE\fR
-Authenticate as \fIUSER\fR.
-.IP
-When a connection is made the server sends a \fB221\fR response before any
-command is received. As its first field this contains a challenge string
-encoded in hex.
-.IP
-The \fIRESPONSE\fR consists of the SHA-1 hash of the user's password
-concatenated with the challenge, encoded in hex.
+Authenticate as \fIUSER\fR. See
+.B AUTHENTICATION
+below.
.TP
.B version
Send back a response with the server version as the second field.
The text part is just commentary (but would normally be a response for this
command) e.g. \fBplaying\fR.
.SH AUTHENTICATION
-The server starts by issuing a challenge line, with response code 231. This
-contains a random challenge encoded in hex.
+When a connection is made the server sends a \fB231\fR response before any
+command is received. This contains an algorithm name and a challenge encoded
+in hex.
+.PP
+Currently the algorithm name is omitted if it is \fBsha1\fR (but this will
+probably change in a future version). The other options are \fBsha256\fR,
+\fBsha384\fR and \fBsha512\fR. \fBSHA1\fR etc work as synonyms.
.PP
-The client should send back a \fBuser\fR command with username and a
-hex-encoded response. The response is the SHA-1 hash of the user's password
-and the challenge.
+The \fBuser\fR response consists of the selected hash of the user's password
+concatenated with the challenge, encoded in hex.
.SH "TRACK INFORMATION"
Track information is encoded in a line (i.e. using the usual line syntax) as
pairs of fields. The first is a name, the second a value. The names have the
Queue entry \fIID\fR was removed. This is used both for explicit removal (when
\fIUSER\fR is present) and when playing a track (when it is absent).
.TP
+.B rescanned
+A rescan completed.
+.TP
.B scratched \fITRACK\fR \fIUSER\fR
\fITRACK\fR was scratched by \fIUSER\fR.
.TP
Some state change occurred. The current set of keywords is:
.RS
.TP
+.B completed
+The current track completed successfully.
+.TP
.B disable_play
Playing was disabled.
.TP
.B enable_random
Random play was enabled.
.TP
+.B failed
+The current track failed.
+.TP
.B pause
The current track was paused.
.TP
+.B playing
+A track started playing.
+.TP
.B resume
The current track was resumed.
+.TP
+.B scratched
+The current track was scratched.
+.PP
+To simplify client implementation, \fBstate\fR commands reflecting the current
+state are sent at the start of the log.
.RE
.TP
.B volume \fILEFT\fR \fIRIGHT\fR
.\" mode:nroff
.\" fill-column:79
.\" End:
-.\" arch-tag:7b6e9931e426d2b810422b20aef38601