---
name: "mservcmd"
section: "1"
platform: "linux"
package: "mserv-client"
version: "0.35-6.4"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/mservcmd"
---

# mservcmd(1)

Mserv command line interface

## NAME

mservcmd - Mserv command line interface

## SYNPOSIS

**mservcmd** \[**-u** *\<user\>* \] \[**-p** *\<password\>* \] \[**-h** *\<host\>:\[\<port\>\]* \]

## DESCRIPTION

**mservcmd** is a command for sending single commands to an mserv server and outputting the results in a suitable way for further processing.

This is not for interactively talking to a server, for that you require a telnet client.

## OPTIONS

- **-u** *\<user\>*

  Specifies the user you wish to connect to the server as.  By default this is the user 'guest'.

- **-p** *\<password\>*

  Specifies the password you wish to connect to the server using.  By default this is the password 'guest'.

- **-h** *\<host\>:\[\<port\>\]*

  Specifies the host (and optionally port) for the server.  By default this is 127.0.0.1 (your machine) with port 4444 (the default mserv port).

## EXAMPLES

- To display the available commands for user bob

  **mservcmd -u bob -p wibble help**

- To display the list of albums

  **mservcmd albums**

- To display the queue contents on 'mserv.zxcv.org'

  **mservcmd -h mserv.zxcv.org queue**

## EXIT STATUS

The exit status is 0 if successful, non-0 otherwise.  If the exit status was 0 then stdout contains the server output.  Any stderr information will be suitable for printing to an untrusted user, e.g. no host information will be printed.

- 0

  Normal exit

- 1

  Parameters to command were incorrect

- 2

  Unknown host

- 3

  Could not connect to host

- 4

  Access denied

- 5

  Read/Write error

## AUTHOR

- Written by:

  James Ponder \<**james@squish.net**\>

## SEE ALSO

- [**mserv**(1)](/mserv/1.md)

  ## WEBSITE

- http://www.mserv.org/
