Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
V
varnishapi
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
uplex-varnish
varnishapi
Commits
aea70272
Commit
aea70272
authored
Aug 25, 2018
by
Geoff Simmons
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add govarnishadm.
parent
bc8a4539
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
252 additions
and
0 deletions
+252
-0
doc.go
cmd/govarnishadm/doc.go
+122
-0
govarnishadm.go
cmd/govarnishadm/govarnishadm.go
+130
-0
No files found.
cmd/govarnishadm/doc.go
0 → 100644
View file @
aea70272
/*-
* Copyright (c) 2018 UPLEX Nils Goroll Systemoptimierung
* All rights reserved
*
* Author: Geoffrey Simmons <geoffrey.simmons@uplex.de>
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
/*
govarnishadm re-implements the varnishadm(1) tool, to demonstrate the
varnishapi admin package.
SYNOPSIS
govarnishadm [-h] [-n ident] [-t timeout] [-S secretfile] [-T [address]:port] [command [...]]
DESCRIPTION
The govarnishadm utility establishes a CLI connection to varnishd
either using -n name or using the -T and -S arguments. If -n name is
given the location of the secret file and the address:port is looked
up in shared memory. If neither is given govarnishadm will look for
an instance without a given name.
If a command is given, the command and arguments are sent over the CLI
connection and the result returned on stdout.
If no command argument is given govarnishadm will pass commands and
replies between the CLI socket and stdin/stdout.
OPTIONS
These command-line options are available:
-h|--help
Print program usage and exit.
-n ident
Connect to the instance of varnishd with this name.
-S secretfile
Specify the authentication secret file. This should be the same -S
argument as was given to varnishd. Only processes which can read the
contents of this file will be able to authenticate the CLI connection.
-t timeout
Wait no longer than this many seconds for an operation to finish.
-T <address:port>
Connect to the management interface at the specified address and port.
The syntax and operation of the actual CLI interface is described in
the varnish-cli(7) manual page. Parameters are described in
varnishd(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 govarnishadm utility is
zero if the command succeeded, and non-zero otherwise.
EXAMPLES
Some ways you can use govarnishadm:
govarnishadm -T localhost:999 -S /var/db/secret vcl.use foo
echo vcl.use foo | govarnishadm -T localhost:999 -S /var/db/secret
echo vcl.use foo | ssh vhost govarnishadm -T localhost:999 -S /var/db/secret
DIFFERENCES FROM VARNISHADM
govarnishadm does not have the command-line completion that may be
possible for varnishadm (if an appropriate library is linked).
govarnishadm cannot detect if it is connected to a tty. So if commands
are piped into stdin, the output in stdout will have the banner and
prompts that appear in interactive mode.
SEE ALSO
* varnishd(1)
* varnish-cli(7)
AUTHORS
The varnishadm utility and its manual page, from which much of the
present documentation was adapted, were written by Cecilie Fritzvold.
The man page was later modified by Per Buer, Federico G. Schwindt and
Lasse Karstensen.
govarnishadm was written by Geoff Simmons.
*/
package
main
cmd/govarnishadm/govarnishadm.go
0 → 100644
View file @
aea70272
/*-
* Copyright (c) 2018 UPLEX Nils Goroll Systemoptimierung
* All rights reserved
*
* Author: Geoffrey Simmons <geoffrey.simmons@uplex.de>
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
package
main
import
(
"uplex.de/varnishapi/pkg/admin"
"bufio"
"flag"
"fmt"
"io"
"io/ioutil"
"os"
"strings"
"time"
)
var
(
instance
=
flag
.
String
(
"n"
,
""
,
"varnish instance name"
)
timeout
=
flag
.
Uint
(
"t"
,
0
,
"timeout"
)
tflag
=
flag
.
String
(
"T"
,
""
,
"[address]:port"
)
sflag
=
flag
.
String
(
"S"
,
""
,
"secretfile"
)
)
func
errExit
(
err
error
)
{
fmt
.
Println
(
err
)
os
.
Exit
(
-
1
)
}
func
main
()
{
var
adm
*
admin
.
Admin
var
admErr
error
flag
.
Parse
()
tmo
:=
time
.
Duration
(
*
timeout
*
uint
(
time
.
Second
))
if
*
tflag
==
""
||
*
sflag
==
""
{
adm
,
admErr
=
admin
.
Attach
(
*
instance
,
tmo
)
}
else
{
sfile
,
err
:=
os
.
Open
(
*
sflag
)
if
err
!=
nil
{
errExit
(
err
)
}
secret
,
err
:=
ioutil
.
ReadAll
(
sfile
)
if
err
!=
nil
{
errExit
(
err
)
}
adm
,
admErr
=
admin
.
Dial
(
*
tflag
,
secret
,
tmo
)
}
if
admErr
!=
nil
{
errExit
(
admErr
)
}
if
len
(
flag
.
Args
())
>
0
{
resp
,
err
:=
adm
.
Command
(
flag
.
Args
()
...
)
if
err
!=
nil
{
errExit
(
err
)
}
fmt
.
Println
(
resp
.
Msg
)
if
resp
.
Code
!=
admin
.
OK
{
fmt
.
Printf
(
"Command failed with error code %d
\n
"
,
resp
.
Code
)
os
.
Exit
(
-
1
)
}
os
.
Exit
(
0
)
}
fmt
.
Println
(
adm
.
Banner
)
fmt
.
Println
()
reader
:=
bufio
.
NewReader
(
os
.
Stdin
)
for
{
fmt
.
Print
(
"varnish> "
)
input
,
err
:=
reader
.
ReadString
(
'\n'
)
if
err
!=
nil
{
if
err
==
io
.
EOF
{
fmt
.
Println
()
os
.
Exit
(
0
)
}
errExit
(
err
)
}
input
=
strings
.
TrimSpace
(
input
)
cmds
:=
strings
.
Split
(
input
,
" "
)
if
tmo
>
0
{
err
:=
adm
.
SetReadDeadline
(
time
.
Now
()
.
Add
(
tmo
))
if
err
!=
nil
{
fmt
.
Println
(
"Error setting read timeout:"
,
err
)
}
}
resp
,
err
:=
adm
.
Command
(
cmds
...
)
if
err
!=
nil
{
errExit
(
err
)
}
fmt
.
Println
(
int
(
resp
.
Code
))
fmt
.
Println
(
resp
.
Msg
)
if
resp
.
Code
==
admin
.
Close
{
os
.
Exit
(
0
)
}
fmt
.
Println
()
}
}
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment