hyperia-sk / memcache-info

Simple and efficient way to show information about Memcache.

Memcache Simple Info

memcache-info is a simple and efficient way to show info about Memcache.

Usage

memcache-info

or execute periodicaly watch --interval=1 "memcache-info -r"

Parameters

memcache-info [ -n | -p | -h | -r ]

-n <ip|hostname>
Name of the host or IP address (default: 127.0.0.1).

-p <port>
Port number (default: 11211).

-h
Prints this help.

-r
Disable interpret ANSI color and style sequences. (default: 0)

Installation

git clone https://github.com/hyperia-sk/memcache-info.git && cd memcache-info

Open up the cloned directory and run:

Unix like OS

sudo make install

For uninstalling

sudo make uninstall

For update/reinstall

sudo make reinstall

OS X (homebrew)

@todo

Windows (cygwin)

@todo

System requirements

• Unix like OS with a proper shell
• Tools we use: nc ; mktemp ; basename ; seq ; bc ; awk ; tr ; printf

Contribution

Want to contribute? Great! First, read this page.

Code reviews

All submissions, including submissions by project members, require review. We use Github pull requests for this purpose.

Some tips for good pull requests:

• Use our code When in doubt, try to stay true to the existing code of the project.
• Write a descriptive commit message. What problem are you solving and what are the consequences? Where and what did you test? Some good tips: here and here.
• If your PR consists of multiple commits which are successive improvements / fixes to your first commit, consider squashing them into a single commit (git rebase -i) such that your PR is a single commit on top of the current HEAD. This make reviewing the code so much easier, and our history more readable.

Formatting

This documentation is written using standard markdown syntax. Please submit your changes using the same syntax.

Tests

make test

Licensing

MIT see LICENSE for the full license text.

memcache-info's Issues

nc keeps connection open after EOF on debian

Not sure what exactly is causing this - maybe it's just a slightly different version of nc on Debian 9. The issue seems to be that nc is keeping the connection open after issuing the stats command. It never returns. Adding -q 1 seems to fix the problem on my system.

I.e.:

slabStats=$(mktemp)
_echo "stats slabs" | nc -q 1 $HOST_NAME $PORT > $slabStats || (_echo "${red}Connect to $HOST_NAME:$PORT failed.${normal}" && exit 1)

stats=$(mktemp)
_echo "stats" | nc -q 1 $HOST_NAME $PORT > $stats