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

FreeBSD Manual Pages

  
 
  

home | help
REMUNGE(1)		  MUNGE	Uid 'N'	Gid Emporium		    REMUNGE(1)

NAME
       remunge - MUNGE credential benchmark

SYNOPSIS
       remunge [OPTION]...

DESCRIPTION
       The  remunge  program benchmarks	the performance	of MUNGE.  A benchmark
       runs for	the specified duration or until	the specified number  of  cre-
       dentials	 are processed,	whichever comes	first.	At its conclusion, the
       number of credentials processed per second is written to	stdout.

       By default, credentials are encoded  for	 one  second  using  a	single
       thread.

OPTIONS
       -h, --help
	      Display a	summary	of the command-line options.

       -L, --license
	      Display license information.

       -V, --version
	      Display version information.

       -q, --quiet
	      Display  only  the creds/sec numeric result.  This is useful for
	      producing	input files for	ministat.

       -c, --cipher string
	      Specify the cipher type, either by name or number.

       -C, --list-ciphers
	      Display a	list of	supported cipher types.

       -m, --mac string
	      Specify the MAC type, either by name or number.

       -M, --list-macs
	      Display a	list of	supported MAC types.

       -z, --zip string
	      Specify the compression type, either by name or number.

       -Z, --list-zips
	      Display a	list of	supported compression types.

       -e, --encode
	      Encode (but do not decode) each credential.   By	bypassing  the
	      decode  operation,  the  credential  is not stored in the	replay
	      cache.

       -d, --decode
	      Encode and decode	each credential.

       -l, --length bytes
	      Specify an arbitrary payload length (in bytes).  The integer may
	      be  followed  by	a  single-character   modifier:	  k=kilobytes,
	      m=megabytes, g=gigabytes;	K=kibibytes, M=mebibytes, G=gibibytes.

       -u, --restrict-uid uid
	      Specify  the  user name or UID allowed to	decode the credential.
	      This will	be matched  against  the  effective  user  ID  of  the
	      process requesting the credential	decode.

       -g, --restrict-gid gid
	      Specify  the group name or GID allowed to	decode the credential.
	      This will	be matched against  the	 effective  group  ID  of  the
	      process  requesting  the credential decode, as well as each sup-
	      plementary group of which	the effective user ID of that  process
	      is a member.

       -t, --ttl seconds
	      Specify  the  time-to-live (in seconds).	This controls how long
	      the credential is	valid once it has been encoded.	 A value of  0
	      selects  the default TTL.	 A value of -1 selects the maximum al-
	      lowed TTL.

       -S, --socket path
	      Specify the local	socket for connecting with munged.

       -D, --duration seconds
	      Specify the test duration	(in seconds).  The default duration is
	      one second.  A value of -1 selects the  maximum  duration.   The
	      integer  may  be followed	by a single-character modifier:	s=sec-
	      onds, m=minutes, h=hours,	d=days.

       -N, --num-creds integer
	      Specify the number of credentials	to generate.  The integer  may
	      be   followed   by  a  single-character  modifier:  k=kilobytes,
	      m=megabytes, g=gigabytes;	K=kibibytes, M=mebibytes, G=gibibytes.

       -T, --num-threads integer
	      Specify the number of threads to spawn  for  processing  creden-
	      tials.

       -W, --warn-time seconds
	      Specify  the  maximum  number  of	 seconds  to allow for a given
	      munge_encode() or	 munge_decode()	 operation  before  issuing  a
	      warning.

EXIT STATUS
       The  remunge  program  returns  a  zero exit code if the	benchmark com-
       pletes.	On error, it prints an error message to	stderr and  returns  a
       non-zero	exit code.

AUTHOR
       Chris Dunlap <cdunlap@llnl.gov>

COPYRIGHT
       Copyright (C) 2007-2024 Lawrence	Livermore National Security, LLC.
       Copyright (C) 2002-2007 The Regents of the University of	California.

       MUNGE  is free software:	you can	redistribute it	and/or modify it under
       the terms of the	GNU General Public License as published	 by  the  Free
       Software	 Foundation,  either version 3 of the License, or (at your op-
       tion) any later version.

       Additionally for	the MUNGE library (libmunge), you can redistribute  it
       and/or  modify  it under	the terms of the GNU Lesser General Public Li-
       cense as	published by the Free Software Foundation, either version 3 of
       the License, or (at your	option)	any later version.

SEE ALSO
       munge(1), unmunge(1), munge(3), munge_ctx(3), munge_enum(3),  munge(7),
       munged(8), mungekey(8).

       https://github.com/dun/munge

munge-0.5.16			  2024-03-15			    REMUNGE(1)

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

home | help