TProof

 Create a PROOF environment. Starting PROOF involves either connecting
 to a master server, which in turn will start a set of slave servers, or
 directly starting as master server (if master = ""). Masterurl is of
 the form: [proof[s]://]host[:port]. Conffile is the name of the config
 file describing the remote PROOF cluster (this argument alows you to
 describe different cluster configurations).
 The default is proof.conf. Confdir is the directory where the config
 file and other PROOF related files are (like motd and noproof files).
 Loglevel is the log level (default = 1). User specified custom config
 files will be first looked for in $HOME/.conffile.

 Protected constructor to be used by classes deriving from TProof
 (they have to call Init themselves and override StartSlaves
 appropriately).

 This constructor simply closes any previous gProof and sets gProof
 to this instance.

 Clean up PROOF environment.

 Start the PROOF environment. Starting PROOF involves either connecting
 to a master server, which in turn will start a set of slave servers, or
 directly starting as master server (if master = ""). For a description
 of the arguments see the TProof ctor. Returns the number of started
 master or slave servers, returns 0 in case of error, in which case
 fValid remains false.

 Set manager and schedule its destruction after this for clean
 operations.

 Start up PROOF slaves.

 Close all open slave servers.
 Client can decide to shutdown the remote session by passing option is 'S'
 or 's'. Default for clients is detach, if supported. Masters always
 shutdown the remote counterpart.

 Create a new TSlave of type TSlave::kSlave.
 Note: creation of TSlave is private with TProof as a friend.
 Derived classes must use this function to create slaves.

 Create a new TSlave of type TSlave::kMaster.
 Note: creation of TSlave is private with TProof as a friend.
 Derived classes must use this function to create slaves.

 Find slave that has TSocket s. Returns 0 in case slave is not found.

 Add to the fUniqueSlave list the active slaves that have a unique
 (user) file system image. This information is used to transfer files
 only once to nodes that share a file system (an image). Submasters
 which are not in fUniqueSlaves are put in the fNonUniqueMasters
 list. That list is used to trigger the transferring of files to
 the submaster's unique slaves without the need to transfer the file
 to the submaster.

 Return number of slaves as described in the config file.

 Return number of active slaves, i.e. slaves that are valid and in
 the current computing group.

 Return number of inactive slaves, i.e. slaves that are valid but not in
 the current computing group.

 Return number of unique slaves, i.e. active slaves that have each a
 unique different user files system.

 Return number of bad slaves. This are slaves that we in the config
 file, but refused to startup or that died during the PROOF session.

 Ask the for the statistics of the slaves.

 Ask the for the number of parallel slaves.

 Ask the master for the list of queries.

 Number of queries processed by this session

 Set max number of draw queries whose results are saved

 Get max number of queries whose full results are kept in the
 remote sandbox

 Return pointer to the list of query results in the player

 Return pointer to the full TQueryResult instance owned by the player
 and referenced by 'ref'. If ref = 0 or "", return the last query result.

 Ask the master for the list of queries.
 Options:
           "A"     show information about all the queries known to the
                   server, i.e. even those processed by other sessions
           "L"     show only information about queries locally available
                   i.e. already retrieved. If "L" is specified, "A" is
                   ignored.
           "F"     show all details available about queries
           "H"     print help menu
 Default ""

 See if the data is ready to be analyzed.

 Send interrupt OOB byte to master or slave servers.

 Returns number of slaves active in parallel mode. Returns 0 in case
 there are no active slaves. Returns -1 in case of error.

 Returns number of slaves active in parallel mode. Returns 0 in case
 there are no active slaves. Returns -1 in case of error.

 Activate slave server list.

 Broadcast a message to all slaves in the specified list. Returns
 the number of slaves the message was successfully sent to.
 Returns -1 in case of error.

 Broadcast a message to all slaves in the specified list (either
 all slaves or only the active slaves). Returns the number of slaves
 the message was successfully sent to. Returns -1 in case of error.

 Broadcast a character string buffer to all slaves in the specified
 list. Use kind to set the TMessage what field. Returns the number of
 slaves the message was sent to. Returns -1 in case of error.

 Broadcast a character string buffer to all slaves in the specified
 list (either all slaves or only the active slaves). Use kind to
 set the TMessage what field. Returns the number of slaves the message
 was sent to. Returns -1 in case of error.

 Broadcast an object to all slaves in the specified list. Use kind to
 set the TMEssage what field. Returns the number of slaves the message
 was sent to. Returns -1 in case of error.

 Broadcast an object to all slaves in the specified list. Use kind to
 set the TMEssage what field. Returns the number of slaves the message
 was sent to. Returns -1 in case of error.

 Broadcast a raw buffer of specified length to all slaves in the
 specified list. Returns the number of slaves the buffer was sent to.
 Returns -1 in case of error.

 Broadcast a raw buffer of specified length to all slaves in the
 specified list. Returns the number of slaves the buffer was sent to.
 Returns -1 in case of error.

 Collect responses from slave sl. Returns the number of slaves that
 responded (=1).
 If timeout >= 0, wait at most timeout seconds (timeout = -1 by default,
 which means wait forever).

 Collect responses from the slave servers. Returns the number of slaves
 that responded.
 If timeout >= 0, wait at most timeout seconds (timeout = -1 by default,
 which means wait forever).

 Collect responses from the slave servers. Returns the number of slaves
 that responded.
 If timeout >= 0, wait at most timeout seconds (timeout = -1 by default,
 which means wait forever).

 Collect responses from the slave servers. Returns the number of messages
 received. Can be 0 if there are no active slaves.
 If timeout >= 0, wait at most timeout seconds (timeout = -1 by default,
 which means wait forever).

 Remove links to objects in list 'ol' from gDirectory

 Collect and analyze available input from socket s.
 Returns 0 on success, -1 if any failure occurs.

 Activate the a-sync input handler.

 De-actiate a-sync input handler.

 Handle input coming from the master server (when this is a client)
 or from a slave server (when this is a master server). This is mainly
 for a-synchronous communication. Normally when PROOF issues a command
 the (slave) server messages are directly handle by Collect().

 Add a bad slave server to the bad slave list and remove it from
 the active list and from the two monitor objects.

 Add slave with socket s to the bad slave list and remove if from
 the active list and from the two monitor objects.

 Ping PROOF. Returns 1 if master server responded.

 Ping PROOF slaves. Returns the number of slaves that responded.

 Print status of PROOF cluster.

 Process a data set (TDSet) using the specified selector (.C) file.
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Get reference for the qry-th query in fQueries (as
 displayed by ShowQueries).

 Finalize the qry-th query in fQueries.
 If force, force retrieval if the query is found in the local list
 but has already been finalized (default kFALSE).
 If query < 0, finalize current query.
 Return 0 on success, -1 on error

 Finalize query with reference ref.
 If force, force retrieval if the query is found in the local list
 but has already been finalized (default kFALSE).
 If ref = 0, finalize current query.
 Return 0 on success, -1 on error

 Send retrieve request for the qry-th query in fQueries.
 If path is defined save it to path.

 Send retrieve request for the query specified by ref.
 If path is defined save it to path.
 Generic method working for all queries known by the server.

 Send remove request for the qry-th query in fQueries.

 Send remove request for the query specified by ref.
 If all = TRUE remove also local copies of the query, if any.
 Generic method working for all queries known by the server.
 This method can be also used to reset the list of queries
 waiting to be processed: for that purpose use ref == "cleanupqueue".

 Send archive request for the qry-th query in fQueries.

 Send archive request for the query specified by ref.
 Generic method working for all queries known by the server.
 If ref == "Default", path is understood as a default path for
 archiving.

 Send cleanup request for the session specified by tag.

 Change query running mode to the one specified by 'mode'.

 Process a data set (TDSet) using the specified selector (.C) file.
 Returns -1 in case of error or number of selected events in case of success.

 Send STOPPROCESS message to master and workers.

 Receive the log file of the slave with socket s.

 Log a message into the appropriate window by emitting a signal.

 Send to all active slaves servers the current slave group size
 and their unique id. Returns number of active slaves.
 Returns -1 in case of error.

 Send command to be executed on the PROOF master and/or slaves.
 If plusMaster is kTRUE then exeucte on slaves and master too.
 Command can be any legal command line command. Commands like
 ".x file.C" or ".L file.C" will cause the file file.C to be send
 to the PROOF cluster. Returns -1 in case of error, >=0 in case of
 succes.

 Send command to be executed on the PROOF master and/or slaves.
 Command can be any legal command line command. Commands like
 ".x file.C" or ".L file.C" will cause the file file.C to be send
 to the PROOF cluster. Returns -1 in case of error, >=0 in case of
 succes.

 Send command to be executed on the PROOF master and/or slaves.
 Command can be any legal command line command, however commands
 like ".x file.C" or ".L file.C" will not cause the file.C to be
 transfered to the PROOF cluster. In that case use TProof::Exec().
 Returns the status send by the remote server as part of the
 kPROOF_LOGDONE message. Typically this is the return code of the
 command on the remote side. Returns -1 in case of error.

 Transfer the current state of the master to the active slave servers.
 The current state includes: the current working directory, etc.
 Returns the number of active slaves. Returns -1 in case of error.

 Transfer the initial (i.e. current) state of the master to all
 slave servers. Currently the initial state includes: log level.
 Returns the number of active slaves. Returns -1 in case of error.

 Check if a file needs to be send to the slave. Use the following
 algorithm:
   - check if file appears in file map
     - if yes, get file's modtime and check against time in map,
       if modtime not same get md5 and compare against md5 in map,
       if not same return kTRUE.
     - if no, get file's md5 and modtime and store in file map, ask
       slave if file exists with specific md5, if yes return kFALSE,
       if no return kTRUE.
 Returns kTRUE in case file needs to be send, returns kFALSE in case
 file is already on remote node.

 Send a file to master or slave servers. Returns number of slaves
 the file was sent to, maybe 0 in case master and slaves have the same
 file system image, -1 in case of error.
 If defined, send to worker 'wrk' only.
 If defined, the full path of the remote path will be rfile.
 The mask 'opt' is an or of ESendFileOpt:

       kAscii  (0x0)      if set true ascii file transfer is used
       kBinary (0x1)      if set true binary file transfer is used
       kForce  (0x2)      if not set an attempt is done to find out
                          whether the file really needs to be downloaded
                          (a valid copy may already exist in the cache
                          from a previous run); the bit is set by
                          UploadPackage, since the check is done elsewhere.
       kForward (0x4)     if set, ask server to forward the file to slave
                          or submaster (meaningless for slave servers).

 Send object to master or slave servers. Returns number of slaves object
 was sent to, -1 in case of error.

 Send print command to master server. Returns number of slaves message
 was sent to. Returns -1 in case of error.

 Set server logging level.

 Tell RPOOF how many slaves to use in parallel. Returns the number of
 parallel slaves. Returns -1 in case of error.

 Tell RPOOF how many slaves to use in parallel. Returns the number of
 parallel slaves. Returns -1 in case of error.

 Go in parallel mode with at most "nodes" slaves. Since the fSlaves
 list is sorted by slave performace the active list will contain first
 the most performant nodes. Returns the number of active slaves.
 Returns -1 in case of error.

 List contents of file cache. If all is true show all caches also on
 slaves. If everything is ok all caches are to be the same.

 Remove files from all file caches.

 List contents of package directory. If all is true show all package
 directries also on slaves. If everything is ok all package directories
 should be the same.

 List which packages are enabled. If all is true show enabled packages
 for all active slaves. If everything is ok all active slaves should
 have the same packages enabled.

 Remove all packages.

 Remove a specific package.

 Remove a specific package.

 Remove all packages.

 Build specified package. Executes the PROOF-INF/BUILD.sh
 script if it exists on all unique nodes. If opt is -1
 then submit build command to slaves, but don't wait
 for results. If opt is 1 then collect result from slaves.
 To be used on the master.
 If opt = 0 (default) then submit and wait for results
 (to be used on the client).
 Returns 0 in case of success and -1 in case of error.

 Build specified package on the client. Executes the PROOF-INF/BUILD.sh
 script if it exists on the client.
 Returns 0 in case of success and -1 in case of error.
 The code is equivalent to the one in TProofServ.cxx (TProof::kBuildPackage
 case). Keep in sync in case of changes.

 Load specified package. Executes the PROOF-INF/SETUP.C script
 on all active nodes. If notOnClient = true, don't load package
 on the client. The default is to load the package also on the client.
 Returns 0 in case of success and -1 in case of error.

 Load specified package in the client. Executes the PROOF-INF/SETUP.C
 script on the client. Returns 0 in case of success and -1 in case of error.
 The code is equivalent to the one in TProofServ.cxx (TProof::kLoadPackage
 case). Keep in sync in case of changes.

 Unload specified package.
 Returns 0 in case of success and -1 in case of error.

 Unload all packages.
 Returns 0 in case of success and -1 in case of error.

 Enable specified package. Executes the PROOF-INF/BUILD.sh
 script if it exists followed by the PROOF-INF/SETUP.C script.
 In case notOnClient = true, don't enable the package on the client.
 The default is to enable packages also on the client.
 Returns 0 in case of success and -1 in case of error.

 Upload a PROOF archive (PAR file). A PAR file is a compressed
 tar file with one special additional directory, PROOF-INF
 (blatantly copied from Java's jar format). It must have the extension
 .par. A PAR file can be directly a binary or a source with a build
 procedure. In the PROOF-INF directory there can be a build script:
 BUILD.sh to be called to build the package, in case of a binary PAR
 file don't specify a build script or make it a no-op. Then there is
 SETUP.C which sets the right environment variables to use the package,
 like LD_LIBRARY_PATH, etc.
 The 'opt' allows to specify whether the .PAR should be just unpacked
 in the existing dir (opt = kUntar, default) or a remove of the existing
 directory should be executed (opt = kRemoveOld), so triggering a full
 re-build. The option if effective only for PROOF protocol > 8 .
 Returns 0 in case of success and -1 in case of error.

 Upload a package on the client in ~/proof/packages.
 The 'opt' allows to specify whether the .PAR should be just unpacked
 in the existing dir (opt = kUntar, default) or a remove of the existing
 directory should be executed (opt = kRemoveOld), thereby triggering a full
 re-build. The option if effective only for PROOF protocol > 8 .
 Returns 0 in case of success and -1 in case of error.

 Add 'libpath' to the lib path search.
 Multiple paths can be specified at once separating them with a comma or
 a blank.
 Return 0 on success, -1 otherwise

 Add 'incpath' to the inc path search.
 Multiple paths can be specified at once separating them with a comma or
 a blank.
 Return 0 on success, -1 otherwise

 Remove 'libpath' from the lib path search.
 Multiple paths can be specified at once separating them with a comma or
 a blank.
 Return 0 on success, -1 otherwise

 Remove 'incpath' from the inc path search.
 Multiple paths can be specified at once separating them with a comma or
 a blank.
 Return 0 on success, -1 otherwise

 Get from the master the list of names of the packages available.

 Get from the master the list of names of the packages enabled.

 Get query progress information. Connect a slot to this signal
 to track progress.

 Get query progress information. Connect a slot to this signal
 to track progress.

 Get list of feedback objects. Connect a slot to this signal
 to monitor the feedback object.

 Close progress dialog.

 Reset progress dialog.

 Send startup message.

 Send dataset preparation status.

 Send data set status

 Notify availability of a query result.

 Validate a TDSet.

 Add objects that might be needed during the processing of
 the selector (see Process()).

 Clear input object list.

 Get specified object that has been produced during the processing
 (see Process()).

 Get list with all object created during processing (see Process()).

 Set input list parameter. If the parameter is already
 set it will be set to the new value.

 Set an input list parameter.

 Set an input list parameter.

 Set an input list parameter.

 Get specified parameter. A parameter set via SetParameter() is either
 a TParameter or a TNamed or 0 in case par is not defined.

 Delete the input list parameters specified by a wildcard (e.g. PROOF_*)
 or exact name (e.g. PROOF_MaxSlavesPerNode).

 Show the input list parameters specified by the wildcard.
 Default is the special PROOF control parameters (PROOF_*).

 Add object to feedback list.

 Remove object from feedback list.

 Clear feedback list.

 Show items in feedback list.

 Return feedback list.

 Creates a tree header (a tree with nonexisting files) object for
 the DataSet.

 Draw feedback creation proxy. When accessed via TProof avoids
 link dependency on libProof.

 Set draw feedback option.

 Delete draw feedback object.

   FIXME: to be written

 Build the PROOF's structure in the browser.

 Construct a TProofPlayer object.

 Add chain to data set

 Remove chain from data set

 Function executed in the slave startup thread.

 Ask for remote logs in the range [start, end]. If start == -1 all the
 messages not yet received are sent back.

 Display log of query pq into the log window frame

 Display on screen the content of the temporary log file for query
 in reference

 Display on screen the content of the temporary log file.
 If qry == -2 show messages from the last (current) query.
 If qry == -1 all the messages not yet displayed are shown (default).
 If qry == 0, all the messages in the file are shown.
 If qry  > 0, only the messages related to query 'qry' are shown.
 For qry != -1 the original file offset is restored at the end

 Set session with 'id' the default one. If 'id' is not found in the list,
 the current session is set as default

 Detach this instance to its proofserv.
 If opt is 'S' or 's' the remote server is shutdown

 Set an alias for this session. If reconnection is supported, the alias
 will be communicated to the remote coordinator so that it can be recovered
 when reconnecting

 Upload a set of files and save the list of files by name dataSetName.
 The 'files' argument is a list of TFileInfo objects describing the files
 as first url.
 The mask 'opt' is a combination of EUploadOpt:
   kAppend             (0x1)   if set true files will be appended to
                               the dataset existing by given name
   kOverwriteDataSet   (0x2)   if dataset with given name exited it
                               would be overwritten
   kNoOverwriteDataSet (0x4)   do not overwirte if the dataset exists
   kOverwriteAllFiles  (0x8)   overwrite all files that may exist
   kOverwriteNoFiles   (0x10)  overwrite none
   kAskUser            (0x0)   ask user before overwriteng dataset/files
 The default value is kAskUser.
 The user will be asked to confirm overwriting dataset or files unless
 specified opt provides the answer!
 If kOverwriteNoFiles is set, then a pointer to TList must be passed as
 skippedFiles argument. The function will add to this list TFileInfo
 objects describing all files that existed on the cluster and were
 not uploaded.

 Communication Summary
 Client                             Master
    |------------>DataSetName----------->|
    |<-------kMESS_OK/kMESS_NOTOK<-------| (Name OK/file exist)
 (*)|-------> call CreateDataSet ------->|
 (*) - optional

 Upload a set of files and save the list of files by name dataSetName.
 The mask 'opt' is a combination of EUploadOpt:
   kAppend             (0x1)   if set true files will be appended to
                               the dataset existing by given name
   kOverwriteDataSet   (0x2)   if dataset with given name exited it
                               would be overwritten
   kNoOverwriteDataSet (0x4)   do not overwirte if the dataset exists
   kOverwriteAllFiles  (0x8)   overwrite all files that may exist
   kOverwriteNoFiles   (0x10)  overwrite none
   kAskUser            (0x0)   ask user before overwriteng dataset/files
 The default value is kAskUser.
 The user will be asked to confirm overwriting dataset or files unless
 specified opt provides the answer!
 If kOverwriteNoFiles is set, then a pointer to TList must be passed as
 skippedFiles argument. The function will add to this list TFileInfo
 objects describing all files that existed on the cluster and were
 not uploaded.

 Upload files listed in "file" to PROOF cluster.
 Where file = name of file containing list of files and
 dataset = dataset name and opt is a combination of EUploadOpt bits.
 Each file description (line) can include wildcards.

 Create a dataSet from files existing on the cluster (listed in files)
 and save it as dataSetName.
 No files are uploaded nor verified to exist on the cluster
 The 'files' argument is a list of TFileInfo objects describing the files
 as first url.
 The mask 'opt' is a combination of EUploadOpt:
   kAppend             (0x1)   if set true files will be appended to
                               the dataset existing by given name
   kOverwriteDataSet   (0x2)   if dataset with given name exited it
                               would be overwritten
   kNoOverwriteDataSet (0x4)   do not overwirte if the dataset exists
   kAskUser            (0x0)   ask user before overwriteng dataset/files
 The default value is kAskUser.
 The user will be asked to confirm overwriting dataset or files unless
 specified opt provides the answer!

 Communication Summary
   Client                              Master
     |------------>DataSetName----------->|
     |<-------kMESS_OK/kMESS_NOTOK<-------| (Name OK/file exist)
  (*)|------->TList of TFileInfo -------->| (dataset to save)
  (*)|<-------kMESS_OK/kMESS_NOTOK<-------| (transaction complete?)
  (*) - optional

 Get TList of TObjStrings with all datasets available on master:
 * with dir undifined - just ls contents of ~/proof/datasets,
 * with dir == "public" - ls ~/proof/datasets/public
 * with dir == "~username/public" - ls ~/username/datasets/public

 Show all datasets uploaded to the cluster (just ls contents of
 ~/proof/datasets or user/proof/datasets/public if 'dir' is defined).
 * with dir undifined - just ls contents of ~/proof/datasets,
 * with dir == "public" - ls ~/proof/datasets/public
 * with dir == "~username/public" - ls ~/username/datasets/public

 Get a list of TFileInfo objects describing the files of the specified
 dataset.

Show content of specific dataset (cat ~/proof/datasets/dataset).

 Remove the specified dataset from the PROOF cluster.
 Files are not deleted.

 Verify if all files in the specified dataset are available.
 Print a list and return the number of missing files.

 If in active in a monitor set ready state

 Make sure that the worker identified by the ordinal number 'ord' is
 in the active list. The request will be forwarded to the master
 in direct contact with the worker. If needed, this master will move
 the worker from the inactive to the active list and rebuild the list
 of unique workers.
 Use ord = "*" to activate all inactive workers.

 Remove the worker identified by the ordinal number 'ord' from the
 the active list. The request will be forwarded to the master
 in direct contact with the worker. If needed, this master will move
 the worker from the active to the inactive list and rebuild the list
 of unique workers.
 Use ord = "*" to deactivate all active workers.

 Modify the worker active/inactive list by making the worker identified by
 the ordinal number 'ord' active (add == TRUE) or inactive (add == FALSE).
 If needed, the request will be forwarded to the master in direct contact
 with the worker. The end-master will move the worker from one list to the
 other active and rebuild the list of unique active workers.
 Use ord = "*" to deactivate all active workers.

 Start a PROOF session on a specific cluster. If cluster is 0 (the
 default) then the PROOF Session Viewer GUI pops up and 0 is returned.
 If cluster is "" (empty string) then we connect to a PROOF session
 on the localhost ("proof://localhost"). Via conffile a specific
 PROOF config file in the confir directory can be specified.
 Use loglevel to set the default loging level for debugging.
 The appropriate instance of TProofMgr is created, if not
 yet existing. The instantiated TProof object is returned.
 Use TProof::cd() to switch between PROOF sessions.
 For more info on PROOF see the TProof ctor.

 Get instance of the effective manager for 'url'
 Return 0 on failure.

 Wrapper around TProofMgr::Reset().

 Get environemnt variables.

 Add an variable to the list of environment variables passed to proofserv
 on the master and slaves

 Remove an variable from the list of environment variables passed to proofserv
 on the master and slaves

 Clear the list of environment variables passed to proofserv
 on the master and slaves

 Save informations about the worker set in the file .workers in the working
 dir. Called each time there is a change in the worker setup, e.g. by
 TProof::MarkBad().