Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VINYLADM(1)		     General Commands Manual		     VINYLADM(1)

NAME
     vinyladm - Control a running Vinyl Cache instance

SYNOPSIS
     vinyladm  [-h]  [-n  workdir]  [-p] [-S secretfile] [-T [address]:port] [-t
     timeout] [command [...]]

DESCRIPTION
     The vinyladm utility establishes a CLI connection to vinyld either using -n
     workdir or using the -T and -S arguments. If -n workdir is given, the loca-
     tion of the secret file and the address:port are looked up in  shared  mem-
     ory.  If  neither	is  given,  vinyladm uses the -n defaults documented for
     vinyld(1).

     If a command is given, the command and arguments are sent over the CLI con-
     nection and the result returned on stdout.

     If no command argument is given vinyladm will pass commands and replies be-
     tween the CLI socket and stdin/stdout.

OPTIONS
     -h     Print program usage and exit.

     -n workdir
	    Specify the Vinyl Cache working directory of the instance to  attach
	    to. See vinyld(1) -n option documentation for additional information
	    and defaults.

     -p     Force  pass mode and make the output follow the VCLI protocol.  This
	    disables command-history/command-completion and makes it easier  for
	    programs to parse the response(s).

     -S secretfile
	    Specify  the  authentication secret file. This should be the same -S
	    argument as was given to vinyld. Only processes which can  read  the
	    contents  of this file, will be able to authenticate the CLI connec-
	    tion.

     -T <address:port>
	    Connect to the management interface at  the  specified  address  and
	    port.

     -t timeout
	    Wait no longer than this many seconds for an operation to finish.

     The  syntax  and  operation of the actual CLI interface is described in the
     vinyl-cli(7) manual page. Parameters  are	described  in  vinyld(1)  manual
     page.

     Additionally,  a  summary	of  commands can be obtained by issuing the help
     command, and a summary  of  parameters  can  be  obtained	by  issuing  the
     param.show command.

EXIT STATUS
     If  a  command is given, the exit status of the vinyladm utility is zero if
     the command succeeded, and non-zero otherwise.

EXAMPLES
     Some ways you can use vinyladm:

	vinyladm -T localhost:999 -S /var/db/secret vcl.use foo
	echo vcl.use foo | vinyladm -T localhost:999 -S /var/db/secret
	echo vcl.use foo | ssh vhost vinyladm -T localhost:999 -S /var/db/secret

SEE ALSO
     * vinyld(1)

     * vinyl-cli(7)

AUTHORS
     The  vinyladm  utility  and  this	manual	page  were  written  by  Cecilie
     Fritzvold.  This  man page has later been modified by Per Buer, Federico G.
     Schwindt and Lasse Karstensen.

								     VINYLADM(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vinyladm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help