class TProof: public TNamed, public TQObject

 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.

 Default initializations

 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 the sandbox path from ' Proof.Sandbox' or the alternative var 'rc'.
 Use the existing setting or the default if nothing is found.
 If 'assert' is kTRUE, make also sure that the path exists.
 Return 0 on success, -1 on failure

 The config file field may contain special instructions which need to be
 parsed at the beginning, e.g. for debug runs with valgrind.
 Several options can be given separated by a ','

 Make sure that 'path' exists; if 'writable' is kTRUE, make also sure
 that the path is writable

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

 Works on the master node only.
 It starts workers on the machines in workerList and sets the paths,
 packages and macros as on the master.
 It is a subbstitute for StartSlaves(...)
 The code is mostly the master part of StartSlaves,
 with the parallel startup removed.

 Set up packages, loaded macros, include and lib paths ...

 Used for shuting down the workres after a query is finished.
 Sends each of the workers from the workerList, a kPROOF_STOP message.
 If the workerList == 0, shutdown all the workers.

 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.

 Get statistics about CPU time, real time and bytes read.
 If verbose, print the resuls (always available via GetCpuTime(), GetRealTime()
 and GetBytesRead()

 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 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 list of TSlaveInfo's. In case of error return 0.

 Activate slave server list.

 Activate (on == TRUE) or deactivate (on == FALSE) all sockets
 monitored by 'mon'.

 Broadcast the group priority to all workers in the specified list. Returns
 the number of workers the message was successfully sent to.
 Returns -1 in case of error.

 Broadcast the group priority to all workers in the specified list. Returns
 the number of workers the message was successfully sent to.
 Returns -1 in case of error.

 Reset the merge progress notificator

 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.

 Broadcast file to all workers in the specified list. Returns the number of workers
 the buffer was sent to.
 Returns -1 in case of error.

 Broadcast file to all workers in the specified list. Returns the number of workers
 the buffer was sent to.
 Returns -1 in case of error.

 Release the used monitor to be used, making sure to delete newly created
 monitors.

 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).
 If defined (>= 0) endtype is the message that stops this collection.

 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).
 If defined (>= 0) endtype is the message that stops this collection.

 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).
 If defined (>= 0) endtype is the message that stops this collection.

 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).
 If defined (>= 0) endtype is the message that stops this collection.
 Collect also stops its execution from time to time to check for new
 workers in Dynamic Startup mode.

 Asks the PROOF Serv for new workers in Dynamic Startup mode and activates
 them. Returns the number of new workers found, or <0 on errors.

 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.

 Analyze the received message.
 Returns 0 on success (1 if this the last message from this socket), -1 if
 any failure occurs.

 Process a message of type kPROOF_SUBMERGER

 Redirect output of worker sl to some merger

 Return a merger, which is both active and still accepts some workers to be
 assigned to it. It works on the 'round-robin' basis.

 Master asks for output from worker sl

 Final update of the progress dialog

 Activate the a-sync input handler.

 De-activate a-sync input handler.

 Get the active mergers count

 Create a new merger

 Add a bad slave server to the bad slave list and remove it from
 the active list and from the two monitor objects. Assume that the work
 done by this worker was lost and ask packerizer to reassign it.

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

 Ask an active worker 'wrk' to terminate, i.e. to shutdown

 Ask an active worker 'ord' to terminate, i.e. to shutdown

 Ping PROOF. Returns 1 if master server responded.

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

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

 Print status of PROOF cluster.

 Extract from opt information about output handling settings.
 The understood keywords are:
     of=<file>, outfile=<file>         output file location
     ds=<dsname>, dataset=<dsname>     dataset name ('of' and 'ds' are
                                       mutually exclusive,execution stops
                                       if both are found)
     sft[=<opt>], savetofile[=<opt>]   control saving to file

 For 'mvf', the <opt> integer has the following meaning:
     <opt> = <how>*10 + <force>
             <force> = 0      save to file if memory threshold is reached
                              (the memory threshold is set by the cluster
                              admin); in case an output file is defined, the
                              files are merged at the end;
                       1      save results to file.
             <how> =   0      save at the end of the query
                       1      save results after each packet (to reduce the
                              loss in case of crash).

 Setting 'ds' automatically sets 'mvf=1'; it is still possible to set 'mvf=11'
 to save results after each packet.

 The separator from the next option is either a ' ' or a ';'

 All recognized settings are removed from the input string opt.
 If action == 0, set up the output file accordingly, if action == 1 clean related
 output file settings.
 If the final target file is local then 'target' is set to the final local path
 when action == 0 and used to retrieve the file with TFile::Cp when action == 1.

 Output file settings are in the form

       <previous_option>of=name <next_option>
       <previous_option>outfile=name,...;<next_option>

 The separator from the next option is either a ' ' or a ';'
 Called interanally by TProof::Process.

 Returns 0 on success, -1 on error.

 Extract from opt in optfb information about wanted feedback settings.
 Feedback are removed from the input string opt.
 If action == 0, set up feedback accordingly, if action == 1 clean related
 feedback settings (using info in optfb, if available, or reparsing opt).

 Feedback requirements are in the form

       <previous_option>fb=name1,name2,name3,... <next_option>
       <previous_option>feedback=name1,name2,name3,...;<next_option>

 The special name 'stats' triggers feedback about events and packets.
 The separator from the next option is either a ' ' or a ';'.
 Called interanally by TProof::Process.

 Process a data set (TDSet) using the specified selector (.C) file or
 Tselector object
 Entry- or event-lists should be set in the data set object using
 TDSet::SetEntryList.
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Process a data set (TFileCollection) using the specified selector (.C) file
 or TSelector object.
 The default tree is analyzed (i.e. the first one found). To specify another
 tree, the default tree can be changed using TFileCollection::SetDefaultMetaData .
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Process a dataset which is stored on the master with name 'dsetname'.
 The syntax for dsetname is name[#[dir/]objname], e.g.
   "mydset"       analysis of the first tree in the top dir of the dataset
                  named "mydset"
   "mydset#T"     analysis tree "T" in the top dir of the dataset
                  named "mydset"
   "mydset#adir/T" analysis tree "T" in the dir "adir" of the dataset
                  named "mydset"
   "mydset#adir/" analysis of the first tree in the dir "adir" of the
                  dataset named "mydset"
 The component 'name' in its more general form contains also the group and
 user name following "/<group>/<user>/<dsname>". Each of these components
 can contain one or more wildcards '*', in which case all the datasets matching
 the expression are added together as a global dataset (wildcard support has
 been added in version 5.27/02).
 The last argument 'elist' specifies an entry- or event-list to be used as
 event selection.
 It is also possible (starting w/ version 5.27/02) to run on multiple datasets
 at once in a more flexible way that the one provided by wildcarding. There
 are three possibilities:
    1) specifying the dataset names separated by the OR operator '|', e.g.
          dsetname = "<dset1>|<dset2>|<dset3>|..."
       in this case the datasets are a seen as a global unique dataset
    2) specifying the dataset names separated by a ',' or a ' ', e.g.
          dsetname = "<dset1>,<dset2> <dset3>,..."
       in this case the datasets are processed one after the other and the
       selector is notified when switching dataset via a bit in the current
       processed element.
    3) giving the path of a textfile where the dataset names are specified
       on one or multiple lines; the lines found are joined as in 1), unless
       the filepath is followed by a ',' (i.e. p->Process("datasets.txt,",...)
       with the dataset names listed in 'datasets.txt') in which case they are
       treated as in 2); the file is open in raw mode with TFile::Open and
       therefore it cane be remote, e.g. on a Web server.
 Each <dsetj> has the format specified above for the single dataset processing,
 included wildcarding (the name of the tree and subdirectory must be same for
 all the datasets).
 In the case of multiple datasets, 'elist' is treated a global entry list.
 It is possible to specify per-dataset entry lists using the syntax
   "mydset[#adir/[T]]?enl=entrylist"
 or
   "mydset[#adir/[T]]<<entrylist"
 Here 'entrylist' is a tag identifying, in the order :
   i. a named entry-list in the input list or in the input data list
  ii. a named entry-list in memory (in gDirectory)
 iii. the path of a file containing the entry-list to be used
 In the case ii) and iii) the entry-list object(s) is(are) added to the input
 data list.
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Generic (non-data based) selector processing: the Process() method of the
 specified selector (.C) or TSelector object is called 'n' times.
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Process a data set (TDSet) using the specified selector object.
 Entry- or event-lists should be set in the data set object using
 TDSet::SetEntryList.
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Process a data set (TFileCollection) using the specified selector object
 The default tree is analyzed (i.e. the first one found). To specify another
 tree, the default tree can be changed using TFileCollection::SetDefaultMetaData .
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Process with name of dataset and TSelector object

 Generic (non-data based) selector processing: the Process() method of the
 specified selector is called 'n' times.
 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'.

 Execute the specified drawing action on a data set (TDSet).
 Event- or Entry-lists should be set in the data set object using
 TDSet::SetEntryList.
 Returns -1 in case of error or number of selected events otherwise.

 Execute the specified drawing action on a data set which is stored on the
 master with name 'dsetname'.
 The syntax for dsetname is name[#[dir/]objname], e.g.
   "mydset"       analysis of the first tree in the top dir of the dataset
                  named "mydset"
   "mydset#T"     analysis tree "T" in the top dir of the dataset
                  named "mydset"
   "mydset#adir/T" analysis tree "T" in the dir "adir" of the dataset
                  named "mydset"
   "mydset#adir/" analysis of the first tree in the dir "adir" of the
                  dataset named "mydset"
 The last argument 'enl' specifies an entry- or event-list to be used as
 event selection.
 The return value is -1 in case of error and TSelector::GetStatus() in
 in case of success.

 Send STOPPROCESS message to master and workers.

 Signal to disable related switches

 Send GOASYNC message to the master.

 Receive the log file of the slave with socket s.

 Notify locally 'msg' to the appropriate units (file, stdout, window)
 If defined, 'sfx' is added after 'msg' (typically a line-feed);

 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.

 Static method to extract the filename (if any) form a CINT command.
 Returns kTRUE and the filename in 'fn'; returns kFALSE if not found or not
 appliable.

 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 node of ordinal 'ord' (use "0" for master).
 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.
 If logtomacro is TRUE the text result of the action is saved in the fMacroLog
 TMacro, accessible via TMacro::GetMacroLog();
 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.

 Get value of environment variable 'env' on node 'ord'

 Get into 'env' the value of integer RC env variable 'rcenv' on node 'ord'

 Get into 'env' the value of double RC env variable 'rcenv' on node 'ord'

 Get into 'env' the value of string RC env variable 'rcenv' on node 'ord'

 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 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.
 The options 'cpopt' define if to copy things from cache to sandbox and what.
 To retrieve from the cache the binaries associated with the file TProof::kCpBin
 must be set in cpopt; the default is copy everything.
 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.
 If rfile = "cache" the file is copied to the remote cache instead of the sandbox
 (to copy to the cache on a different name use rfile = "cache:newname").
 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).
       kCpBin   (0x8)     Retrieve from the cache the binaries associated
                          with the file
       kCp      (0x10)    Retrieve the files from the cache

 Sends an object to master and workers and expect them to send back a
 message with the output of its TObject::Print(). Returns -1 on error, the
 number of workers that received the objects on success.

 Sends a string to master and workers and expect them to echo it back to
 the client via a message. It is a special case of the generic Echo()
 that works with TObjects. Returns -1 on error, the number of workers that
 received the message on success.

 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.

 Switch ON/OFF the real-time logging facility. When this option is
 ON, log messages from processing are sent back as they come, instead of
 being sent back at the end in one go. This may help debugging or monitoring
 in some cases, but, depending on the amount of log, it may have significant
 consequencies on the load over the network, so it must be used with care.

 Tell PROOF how many slaves to use in parallel. If random is TRUE a random
 selection is done (if nodes is less than the available nodes).
 Returns the number of parallel slaves. Returns -1 in case of error.

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

 Add nWorkersToAdd workers to current list of workers. This function is
 works on the master only, and only when an analysis is ongoing. A message
 is sent back to the client when we go "more" parallel.
 Returns -1 on error, number of total (not added!) workers on success.

 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.
 If random is TRUE, and nodes is less than the number of available workers,
 a random selection is done.
 Returns -1 in case of error.

 List contents of the data directory in the sandbox.
 This is the place where files produced by the client queries are kept

 Remove files for the data directory.
 The option 'what' can take the values:
     kPurge                 remove all files and directories under '~/data'
     kUnregistered          remove only files not in registered datasets (default)
     kDataset               remove files belonging to dataset 'dsname'
 User is prompt for confirmation, unless kForceClear is ORed with the option

 Prompt the question 'p' requiring an answer y,Y,n,N
 Return kTRUE is the answer was y or Y, kFALSE in all other cases.

 Progress bar for clear data

 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 file from all file caches. If file is 0 or "" or "*", remove all
 the files

 Exec system command 'cmd'. If fdout > -1, append the output to fdout.

 List contents of package directory. If all is true show all package
 directories also on slaves. If everything is ok all package directories
 should be the same. If redir is kTRUE the result is redirected to the log
 file (option available for internal actions).

 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.
 Returns 0 in case of success and -1 in case of error.

 Remove a specific package.
 Returns 0 in case of success and -1 in case of error.

 Remove a specific package.
 Returns 0 in case of success and -1 in case of error.

 Remove a specific package 'pack' from the client.
 Returns 0 in case of success and -1 in case of error.

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

 Build specified package. Executes the PROOF-INF/BUILD.sh
 script if it exists on all unique nodes. If opt is kBuildOnSlavesNoWait
 then submit build command to slaves, but don't wait
 for results. If opt is kCollectBuildResults then collect result
 from slaves. To be used on the master.
 If opt = kBuildAll (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.
 If opt == 0, both the preparation and building phases are run.
 If opt == 1, only the preparation phase (asserting and, eventually, downloading
              of the package) is done; '*path' contains the full path to the
              package to be passed in the next call
 If opt == 2, only the building phase is run using *path .
 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.
 The argument 'loadopts' specify a list of objects to be passed to the SETUP.
 The objects in the list must be streamable; the SETUP macro will be executed
 like this: SETUP.C(loadopts).
 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.
 The argument 'loadopts' specify a list of objects to be passed to the SETUP.
 The objects in the list must be streamable; the SETUP macro will be executed
 like this: SETUP.C(loadopts).
 Returns 0 in case of success and -1 in case of error.

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

 Unload a specific package 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::UnloadPackage
 case). Keep in sync in case of changes.

 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.
 If specified, enables packages only on the specified workers.
 Returns 0 in case of success and -1 in case of error.
 Provided for backward compatibility.

 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.
 It is is possible to specify options for the loading step via 'loadopts';
 the string will be passed passed as argument to SETUP.
 Special option 'chkv=<o>' (or 'checkversion=<o>') can be used to control
 plugin version checking during building: possible choices are:
     off         no check; failure may occur at loading
     on          check ROOT version [default]
     svn         check ROOT version and SVN revision number.
 (Use ';', ' ' or '|' to separate 'chkv=<o>' from the rest.)
 If specified, enables packages only on the specified workers.
 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.
 It is is possible to specify a list of objects to be passed to the SETUP
 functions via 'loadopts'; the objects must be streamable.
 Returns 0 in case of success and -1 in case of error.

 Download a PROOF archive (PAR file) from the master package repository.
 The PAR file is downloaded in the current directory or in the directory
 specified by 'dstdir'. If a package with the same name already exists
 at destination, a check on the MD5 sum is done and the user warned or
 prompted for action, depending is the file is equal or different.
 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 .
 The lab 'dirlab' (e.g. 'G0') indicates that the package is to uploaded to
 an alternative global directory for global usage. This may require special
 privileges.
 If download is kTRUE and the package is not found locally, then it is downloaded
 from the master repository.
 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. This option if effective only for PROOF protocol > 8.
 Returns 0 in case of success and -1 in case of error.

 Load the specified macro on master, workers and, if notOnClient is
 kFALSE, on the client. The macro file is uploaded if new or updated.
 Additional files to be uploaded (or updated, if needed) can be specified
 after a comma, e.g. "mymacro.C+,thisheader.h,thatheader.h".
 If existing in the same directory, a header basename(macro).h or .hh, is also
 uploaded.
 The default is to load the macro also on the client; notOnClient can be used
 to avoid loading on the client.
 On masters, if uniqueWorkers is kTRUE, the macro is loaded on unique workers
 only, and collection is not done; if uniqueWorkers is kFALSE, collection
 from the previous request is done, and broadcasting + collection from the
 other workers is done.
 The wrks arg can be used on the master to limit the set of workers.
 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

 Handle lib, inc search paths modification request

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

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

 Print a progress bar on stderr. Used in batch mode.

 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 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 or notify data set status

 Notify availability of a query result.

 Validate a TDSet.

 Add data objects that might be needed during the processing of
 the selector (see Process()). This object can be very large, so they
 are distributed in an optimized way using a dedicated file.
 If push is TRUE the input data are sent over even if no apparent change
 occured to the list.

 Remove obj form the input data list; if obj is null (default), clear the
 input data info.

 Remove obj 'name' form the input data list;

 Set the file to be used to optimally distribute the input data objects.
 If the file exists the object in the file are added to those in the
 fInputData list. If the file path is null, a default file will be created
 at the moment of sending the processing request with the content of
 the fInputData list. See also SendInputDataFile.

 Send the input data objects to the master; the objects are taken from the
 dedicated list and / or the specified file.
 If the fInputData is empty the specified file is sent over.
 If there is no specified file, a file named "inputdata.root" is created locally
 with the content of fInputData and sent over to the master.
 If both fInputData and the specified file are not empty, a copy of the file
 is made locally and augmented with the content of fInputData.

 Prepare the file with the input data objects to be sent the master; the
 objects are taken from the dedicated list and / or the specified file.
 If the fInputData is empty the specified file is sent over.
 If there is no specified file, a file named "inputdata.root" is created locally
 with the content of fInputData and sent over to the master.
 If both fInputData and the specified file are not empty, a copy of the file
 is made locally and augmented with the content of fInputData.

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

 Clear input object list.

 Get input list.

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

 Find object 'name' in list 'out' or in the files specified in there

 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.

 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 libProofPlayer.

 Set draw feedback option.

 Delete draw feedback object.

   FIXME: to be written

 Build the PROOF's structure in the browser.

 Set a new PROOF player.

 Construct a TProofPlayer object. The player string specifies which
 player should be created: remote, slave, sm (supermaster) or base.
 Default is remote. Socket is needed in case a slave player is created.

 Add chain to data set

 Remove chain from data set

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

 Fill a TMacro with the log lines since the last reading (fLogFileR)
 Return (TMacro *)0 if no line was logged.
 The returned TMacro must be deleted by the caller.

 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

 *** This function is deprecated and will disappear in future versions ***
 *** It is just a wrapper around TFile::Cp.
 *** Please use TProofMgr::UploadFiles.

 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 RegisterDataSet ------->|
 (*) - optional

 *** This function is deprecated and will disappear in future versions ***
 *** It is just a wrapper around TFile::Cp.
 *** Please use TProofMgr::UploadFiles.

 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.

 *** This function is deprecated and will disappear in future versions ***
 *** It is just a wrapper around TFile::Cp.
 *** Please use TProofMgr::UploadFiles.

 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.
 Check TFileInfo compatibility

 Register the 'dataSet' on the cluster under the current
 user, group and the given 'dataSetName'.
 If a dataset with the same name already exists the action fails unless 'opts'
 contains 'O', in which case the old dataset is overwritten, or contains 'U',
 in which case 'newDataSet' is added to the existing dataset (duplications are
 ignored, if any).
 If 'opts' contains 'V' the dataset files are also verified (if the dataset manager
 is configured to allow so). By default the dataset is not verified.
 If 'opts' contains 'T' the in the dataset object (status bits, meta,...)
 is trusted, i.e. not reset (if the dataset manager is configured to allow so).
 If 'opts' contains 'S' validation would be run serially (meaningful only if
 validation is required).
 Returns kTRUE on success.

 Set/Change the name of the default tree. The tree name may contain
 subdir specification in the form "subdir/name".
 Returns 0 on success, -1 otherwise.

 Lists all datasets that match given uri.
 The 'optStr' can contain a comma-separated list of servers for which the
 information is wanted. If ':lite:' (case insensitive) is specified in 'optStr'
 only the global information in the TFileCollection is retrieved; useful to only
 get the list of available datasets.

 Shows datasets in locations that match the uri.
 By default shows the user's datasets and global ones

 Returns kTRUE if 'dataset' exists, kFALSE otherwise

 Clear the content of the dataset cache, if any (matching 'dataset', if defined).

 Display the content of the dataset cache, if any (matching 'dataset', if defined).

 Get a list of TFileInfo objects describing the files of the specified
 dataset.
 To get the short version (containing only the global meta information)
 specify optStr = "S:" or optStr = "short:".
 To get the sub-dataset of files located on a given server(s) specify
 the list of servers (comma-separated) in the 'optStr' field.

 display meta-info for given dataset usi

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

 Find datasets, returns in a TList all found datasets.

 Allows users to request staging of a particular dataset. Requests are
 saved in a special dataset repository and must be honored by the endpoint.

 Cancels a dataset staging request. Returns kTRUE on success, kFALSE on
 failure. Dataset not found equals to a failure.

 Obtains a TFileCollection showing the staging status of the specified
 dataset. A valid dataset manager and dataset staging requests repository
 must be present on the endpoint.

 Like GetStagingStatusDataSet, but displays results immediately.

 Verify if all files in the specified dataset are available.
 Print a list and return the number of missing files.
 Returns -1 in case of error.

 Internal function for parallel dataset verification used TProof::VerifyDataSet and
 TProofLite::VerifyDataSet

 returns a map of the quotas of all groups

 shows the quota and usage of all groups
 if opt contains "U" shows also distribution of usage on user-level

 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.
 The string 'ord' can also be a comma-separated list of ordinal numbers the
 status of which will be modified at once.
 Return <0 if something went wrong (-2 if at least one worker was not found)
 or the number of workers with status change (on master; 0 on client).