remunge(1)

1
2REMUNGE(1)                MUNGE Uid 'N' Gid Emporium                REMUNGE(1)
3
4
5

NAME

7       remunge - MUNGE credential benchmark
8
9

SYNOPSIS

11       remunge [OPTION]...
12
13

DESCRIPTION

15       The  remunge  program benchmarks the performance of MUNGE.  A benchmark
16       runs for the specified duration or until the specified number  of  cre‐
17       dentials  are processed, whichever comes first.  At its conclusion, the
18       number of credentials processed per second is written to stdout.
19
20       By default, credentials are encoded  for  one  second  using  a  single
21       thread.
22
23

OPTIONS

25       -h, --help
26              Display a summary of the command-line options.
27
28       -L, --license
29              Display license information.
30
31       -V, --version
32              Display version information.
33
34       -q, --quiet
35              Display  only  the creds/sec numeric result.  This is useful for
36              producing input files for ministat.
37
38       -c, --cipher string
39              Specify the cipher type, either by name or number.
40
41       -C, --list-ciphers
42              Display a list of supported cipher types.
43
44       -m, --mac string
45              Specify the MAC type, either by name or number.
46
47       -M, --list-macs
48              Display a list of supported MAC types.
49
50       -z, --zip string
51              Specify the compression type, either by name or number.
52
53       -Z, --list-zips
54              Display a list of supported compression types.
55
56       -e, --encode
57              Encode (but do not decode) each credential.   By  bypassing  the
58              decode  operation,  the  credential  is not stored in the replay
59              cache.
60
61       -d, --decode
62              Encode and decode each credential.
63
64       -l, --length integer
65              Specify an arbitrary payload length (in bytes).  The integer may
66              be   followed   by  a  single-character  modifier:  k=kilobytes,
67              m=megabytes, g=gigabytes; K=kibibytes, M=mebibytes, G=gibibytes.
68
69       -u, --restrict-uid uid
70              Specify the user name or UID allowed to decode  the  credential.
71              This  will  be  matched  against  the  effective  user ID of the
72              process requesting the credential decode.
73
74       -g, --restrict-gid gid
75              Specify the group name or GID allowed to decode the  credential.
76              This  will  be  matched  against  the  effective group ID of the
77              process requesting the credential decode, as well as  each  sup‐
78              plementary  group of which the effective user ID of that process
79              is a member.
80
81       -t, --ttl integer
82              Specify the time-to-live (in seconds).  This controls  how  long
83              the  credential is valid once it has been encoded.  A value of 0
84              selects the default TTL.  A value  of  -1  selects  the  maximum
85              allowed TTL.
86
87       -S, --socket path
88              Specify the local domain socket for connecting with munged.
89
90       -D, --duration integer
91              Specify the test duration (in seconds).  The default duration is
92              one second.  A value of -1 selects the  maximum  duration.   The
93              integer  may  be followed by a single-character modifier: s=sec‐
94              onds, m=minutes, h=hours, d=days.
95
96       -N, --num-creds integer
97              Specify the number of credentials to generate.  The integer  may
98              be   followed   by  a  single-character  modifier:  k=kilobytes,
99              m=megabytes, g=gigabytes; K=kibibytes, M=mebibytes, G=gibibytes.
100
101       -T, --num-threads integer
102              Specify the number of threads to spawn  for  processing  creden‐
103              tials.
104
105       -W, --warn-time integer
106              Specify  the  maximum  number  of  seconds  to allow for a given
107              munge_encode() or  munge_decode()  operation  before  issuing  a
108              warning.
109
110

EXIT STATUS

112       The  remunge  program  returns  a  zero exit code if the benchmark com‐
113       pletes.  On error, it prints an error message to stderr and  returns  a
114       non-zero exit code.
115
116

AUTHOR

118       Chris Dunlap <cdunlap@llnl.gov>
119
120

COPYRIGHT

122       Copyright (C) 2007-2017 Lawrence Livermore National Security, LLC.
123       Copyright (C) 2002-2007 The Regents of the University of California.
124
125       MUNGE  is free software: you can redistribute it and/or modify it under
126       the terms of the GNU General Public License as published  by  the  Free
127       Software  Foundation,  either  version  3  of  the License, or (at your
128       option) any later version.
129
130       Additionally for the MUNGE library (libmunge), you can redistribute  it
131       and/or  modify  it  under  the  terms  of the GNU Lesser General Public
132       License as published by the Free Software Foundation, either version  3
133       of the License, or (at your option) any later version.
134
135