251 lines
11 KiB
C
Executable File
251 lines
11 KiB
C
Executable File
/* -*- mode: c; indent-tabs-mode: nil; -*-
|
|
* vim:expandtab:
|
|
*
|
|
* NOTE: Someone was setting indent-sizes in the mode-line. Don't do that.
|
|
* 8-chars of indenting is ridiculous. If you really want 8-spaces,
|
|
* then change the mode-line to use tabs, and configure your personal
|
|
* editor environment to use 8-space tab-stops.
|
|
*
|
|
*/
|
|
/******************************************************************************\
|
|
* *
|
|
* Copyright (c) 2003, The Regents of the University of California *
|
|
* See the file COPYRIGHT for a complete copyright notice and license. *
|
|
* *
|
|
\******************************************************************************/
|
|
|
|
#ifndef _IOR_H
|
|
#define _IOR_H
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
# include "config.h"
|
|
#endif
|
|
|
|
#ifdef USE_HDFS_AIORI
|
|
# include <hdfs.h> /* hdfsFS */
|
|
#else
|
|
# include <stdint.h>
|
|
typedef uint16_t tPort; /* unused, but needs a type */
|
|
typedef void* hdfsFS; /* unused, but needs a type */
|
|
#endif
|
|
|
|
#ifdef USE_RADOS_AIORI
|
|
# include <rados/librados.h>
|
|
#else
|
|
typedef void *rados_t;
|
|
typedef void *rados_ioctx_t;
|
|
#endif
|
|
|
|
#include "iordef.h"
|
|
/******************** DATA Packet Type ***************************************/
|
|
/* Holds the types of data packets: generic, offset, timestamp, incompressible */
|
|
|
|
enum PACKET_TYPE
|
|
{
|
|
generic = 0, /* No packet type specified */
|
|
timestamp=1, /* Timestamp packet set with -l */
|
|
offset=2, /* Offset packet set with -l */
|
|
incompressible=3 /* Incompressible packet set with -l */
|
|
|
|
};
|
|
|
|
|
|
|
|
/***************** IOR_BUFFERS *************************************************/
|
|
/* A struct to hold the buffers so we can pass 1 pointer around instead of 3
|
|
*/
|
|
|
|
typedef struct IO_BUFFERS
|
|
{
|
|
void* buffer;
|
|
void* checkBuffer;
|
|
void* readCheckBuffer;
|
|
|
|
} IOR_io_buffers;
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
* The parameter struct holds all of the "global" data to be passed,
|
|
* as well as results to be parsed.
|
|
*
|
|
* NOTE: If IOR_Param_t is changed, also change:
|
|
* init_IOR_Param_t() [ior.c]
|
|
* DisplayUsage() [ior.c]
|
|
* ShowTest() [ior.c]
|
|
* DecodeDirective() [parse_options.c]
|
|
* ParseCommandLine() [parse_options.c]
|
|
* USER_GUIDE
|
|
*/
|
|
|
|
struct ior_aiori;
|
|
|
|
typedef struct
|
|
{
|
|
const struct ior_aiori * backend;
|
|
char * debug; /* debug info string */
|
|
unsigned int mode; /* file permissions */
|
|
unsigned int openFlags; /* open flags (see also <open>) */
|
|
int referenceNumber; /* user supplied reference number */
|
|
char * api; /* API for I/O */
|
|
char * apiVersion; /* API version */
|
|
char * platform; /* platform type */
|
|
char * testFileName; /* full name for test */
|
|
char * testFileName_fppReadCheck;/* filename for fpp read check */
|
|
char * hintsFileName; /* full name for hints file */
|
|
char * options; /* options string */
|
|
int numTasks; /* number of tasks for test */
|
|
int nodes; /* number of nodes for test */
|
|
int tasksPerNode; /* number of tasks per node */
|
|
int repetitions; /* number of repetitions of test */
|
|
int repCounter; /* rep counter */
|
|
int multiFile; /* multiple files */
|
|
int interTestDelay; /* delay between reps in seconds */
|
|
int interIODelay; /* delay after each I/O in us */
|
|
int open; /* flag for writing or reading */
|
|
int readFile; /* read of existing file */
|
|
int writeFile; /* write of file */
|
|
int filePerProc; /* single file or file-per-process */
|
|
int reorderTasks; /* reorder tasks for read back and check */
|
|
int taskPerNodeOffset; /* task node offset for reading files */
|
|
int reorderTasksRandom; /* reorder tasks for random file read back */
|
|
int reorderTasksRandomSeed; /* reorder tasks for random file read seed */
|
|
int checkWrite; /* check read after write */
|
|
int checkRead; /* check read after read */
|
|
int keepFile; /* don't delete the testfile on exit */
|
|
int keepFileWithError; /* don't delete the testfile with errors */
|
|
int errorFound; /* error found in data check */
|
|
int quitOnError; /* quit code when error in check */
|
|
int collective; /* collective I/O */
|
|
IOR_offset_t segmentCount; /* number of segments (or HDF5 datasets) */
|
|
IOR_offset_t blockSize; /* contiguous bytes to write per task */
|
|
IOR_offset_t transferSize; /* size of transfer in bytes */
|
|
IOR_offset_t offset; /* offset for read/write */
|
|
IOR_offset_t expectedAggFileSize; /* calculated aggregate file size */
|
|
int preallocate; /* preallocate file size */
|
|
int useFileView; /* use MPI_File_set_view */
|
|
int useSharedFilePointer; /* use shared file pointer */
|
|
int useStridedDatatype; /* put strided access into datatype */
|
|
int useO_DIRECT; /* use O_DIRECT, bypassing I/O buffers */
|
|
int showHints; /* show hints */
|
|
int summary_every_test; /* flag to print summary every test, not just at end */
|
|
int uniqueDir; /* use unique directory for each fpp */
|
|
int useExistingTestFile; /* do not delete test file before access */
|
|
int storeFileOffset; /* use file offset as stored signature */
|
|
int deadlineForStonewalling; /* max time in seconds to run any test phase */
|
|
int stoneWallingWearOut; /* wear out the stonewalling, once the timout is over, each process has to write the same amount */
|
|
uint64_t stoneWallingWearOutIterations; /* the number of iterations for the stonewallingWearOut, needed for readBack */
|
|
char * stoneWallingStatusFile;
|
|
|
|
int maxTimeDuration; /* max time in minutes to run each test */
|
|
int outlierThreshold; /* warn on outlier N seconds from mean */
|
|
int verbose; /* verbosity */
|
|
int setTimeStampSignature; /* set time stamp signature */
|
|
unsigned int timeStampSignatureValue; /* value for time stamp signature */
|
|
void * fd_fppReadCheck; /* additional fd for fpp read check */
|
|
int randomSeed; /* random seed for write/read check */
|
|
unsigned int incompressibleSeed; /* random seed for incompressible file creation */
|
|
int randomOffset; /* access is to random offsets */
|
|
size_t memoryPerTask; /* additional memory used per task */
|
|
size_t memoryPerNode; /* additional memory used per node */
|
|
enum PACKET_TYPE dataPacketType; /* The type of data packet. */
|
|
|
|
|
|
/* POSIX variables */
|
|
int singleXferAttempt; /* do not retry transfer if incomplete */
|
|
int fsyncPerWrite; /* fsync() after each write */
|
|
int fsync; /* fsync() after write */
|
|
|
|
void* mmap_ptr;
|
|
|
|
/* MPI variables */
|
|
MPI_Comm testComm; /* MPI communicator */
|
|
MPI_Datatype transferType; /* datatype for transfer */
|
|
MPI_Datatype fileType; /* filetype for file view */
|
|
|
|
/* HDF5 variables */
|
|
int individualDataSets; /* datasets not shared by all procs */
|
|
int noFill; /* no fill in file creation */
|
|
IOR_offset_t setAlignment; /* alignment in bytes */
|
|
|
|
/* HDFS variables */
|
|
char * hdfs_user; /* copied from ENV, for now */
|
|
const char* hdfs_name_node;
|
|
tPort hdfs_name_node_port; /* (uint16_t) */
|
|
hdfsFS hdfs_fs; /* file-system handle */
|
|
int hdfs_replicas; /* n block replicas. (0 gets default) */
|
|
int hdfs_block_size; /* internal blk-size. (0 gets default) */
|
|
|
|
char* URI; /* "path" to target object */
|
|
size_t part_number; /* multi-part upload increment (PER-RANK!) */
|
|
char* UploadId; /* key for multi-part-uploads */
|
|
int collective_md; /* use collective metatata optimization */
|
|
|
|
/* RADOS variables */
|
|
rados_t rados_cluster; /* RADOS cluster handle */
|
|
rados_ioctx_t rados_ioctx; /* I/O context for our pool in the RADOS cluster */
|
|
|
|
/* NCMPI variables */
|
|
int var_id; /* variable id handle for data set */
|
|
|
|
/* Lustre variables */
|
|
int lustre_stripe_count;
|
|
int lustre_stripe_size;
|
|
int lustre_start_ost;
|
|
int lustre_set_striping; /* flag that we need to set lustre striping */
|
|
int lustre_ignore_locks;
|
|
|
|
/* gpfs variables */
|
|
int gpfs_hint_access; /* use gpfs "access range" hint */
|
|
int gpfs_release_token; /* immediately release GPFS tokens after
|
|
creating or opening a file */
|
|
/* beegfs variables */
|
|
int beegfs_numTargets; /* number storage targets to use */
|
|
int beegfs_chunkSize; /* srtipe pattern for new files */
|
|
|
|
int id; /* test's unique ID */
|
|
int intraTestBarriers; /* barriers between open/op and op/close */
|
|
} IOR_param_t;
|
|
|
|
/* each pointer for a single test */
|
|
typedef struct {
|
|
double time;
|
|
size_t pairs_accessed; // number of I/Os done, useful for deadlineForStonewalling
|
|
|
|
double stonewall_time;
|
|
long long stonewall_min_data_accessed;
|
|
long long stonewall_avg_data_accessed;
|
|
|
|
IOR_offset_t aggFileSizeFromStat;
|
|
IOR_offset_t aggFileSizeFromXfer;
|
|
IOR_offset_t aggFileSizeForBW;
|
|
} IOR_point_t;
|
|
|
|
typedef struct {
|
|
int errors;
|
|
IOR_point_t write;
|
|
IOR_point_t read;
|
|
} IOR_results_t;
|
|
|
|
/* define the queuing structure for the test parameters */
|
|
typedef struct IOR_test_t {
|
|
IOR_param_t params;
|
|
IOR_results_t *results;
|
|
struct IOR_test_t *next;
|
|
} IOR_test_t;
|
|
|
|
IOR_test_t *CreateTest(IOR_param_t *init_params, int test_num);
|
|
void AllocResults(IOR_test_t *test);
|
|
|
|
char * GetPlatformName();
|
|
void init_IOR_Param_t(IOR_param_t *p);
|
|
|
|
/*
|
|
* This function runs IOR given by command line, useful for testing
|
|
*/
|
|
IOR_test_t * ior_run(int argc, char **argv, MPI_Comm world_com, FILE * out_logfile);
|
|
|
|
/* Actual IOR Main function, renamed to allow library usage */
|
|
int ior_main(int argc, char **argv);
|
|
|
|
#endif /* !_IOR_H */
|