doc/ping_pong.1

   1 '\" t
   2 .\"     Title: ping_pong
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 03/26/2011
   6 .\"    Manual:
   7 .\"    Source:
   8 .\"  Language: English
   9 .\"
  10 .TH "PING_PONG" "1" "03/26/2011" "" ""
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 ping_pong \- measures the ping\-pong byte range lock latency
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBping_pong\ [options]\ <file>\ <num_locks>\fR\ 'u
  34 \fBping_pong [options] <file> <num_locks>\fR
  35 .HP \w'\fBping_pong\fR\ 'u
  36 \fBping_pong\fR [\-r] [\-w] [\-m]
  37 .SH "DESCRIPTION"
  38 .PP
  39 This measures the ping\-pong byte range lock latency\&. It is especially useful on a cluster of nodes sharing a common lock manager as it will give some indication of the lock managers performance under stress\&.
  40 .SH "OPTIONS"
  41 .PP
  42 \-r
  43 .RS 4
  44 do reads
  45 .RE
  46 .PP
  47 \-w
  48 .RS 4
  49 do writes
  50 .RE
  51 .PP
  52 \-m
  53 .RS 4
  54 use mmap
  55 .RE
  56 .SH "EXAMPLES"
  57 .PP
  58 Testing lock coherence
  59 .sp
  60 .if n \{\
  61 .RS 4
  62 .\}
  63 .nf
  64       ping_pong test\&.dat N
  65
  66 .fi
  67 .if n \{\
  68 .RE
  69 .\}
  70 .PP
  71 Testing IO coherence
  72 .sp
  73 .if n \{\
  74 .RS 4
  75 .\}
  76 .nf
  77       ping_pong \-rw test\&.dat N
  78
  79 .fi
  80 .if n \{\
  81 .RE
  82 .\}
  83 .SH "SEE ALSO"
  84 .PP
  85
  86 \m[blue]\fB\%https://wiki.samba.org/index.php/Ping_pong\fR\m[], ctdb(1), ctdbd(1)
  87 .SH "COPYRIGHT/LICENSE"
  88 .sp
  89 .if n \{\
  90 .RS 4
  91 .\}
  92 .nf
  93 Copyright (C) Andrew Tridgell 2002
  94
  95 This program is free software; you can redistribute it and/or modify
  96 it under the terms of the GNU General Public License as published by
  97 the Free Software Foundation; either version 3 of the License, or (at
  98 your option) any later version\&.
  99
 100 This program is distributed in the hope that it will be useful, but
 101 WITHOUT ANY WARRANTY; without even the implied warranty of
 102 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&.  See the GNU
 103 General Public License for more details\&.
 104
 105 You should have received a copy of the GNU General Public License
 106 along with this program; if not, see http://www\&.gnu\&.org/licenses/\&.
 107 .fi
 108 .if n \{\
 109 .RE
 110 .\}