documentation: explanation / context of the "STAT" column in plotman status

some explanation / context around the plotting statuses would be helpful and likely prevent further issues from being filed:

$ plotman status
 plot id    k           tmp            dst   wall   phase    tmp    pid   stat    mem   user    sys   io
d100ec50   32   /chia-plot1   /chia-buffer   1:14     1:5   175G   2551    SLP   4.9G   1:39   0:03   2s
dafd1a46   32   /chia-plot0   /chia-buffer   1:44     1:7   173G   1987    SLP   4.7G   2:25   0:05   2s

reference: https://github.com/ericaltendorf/plotman/issues/199#issuecomment-830617370

[Monstarules]

@piotrkochan commenting with code from this repository isn’t the answer to this question. There’s more to it than that. The actual question was in regards to what the different statuses mean, and how to make them clearer, as mentioned in #199 . After reading the documentation of psutil, Chia, Plotman, and Linux status codes, I’m going to attempt to take a stab at possibly providing some insight:

RUN The process is currently running, meaning that it is reading and or writing data to the disk. Self explanatory.

SLEEP The process itself is asleep, as it is not reading or writing data to the disk. Chia in general will call several other processes when making a plot. It is not uncommon for a few processes to be in a standby mode, especially the actual “plot” process, of which the status we see in Plotman. Status SLP does not mean that your plotting has stopped.

DSK The disk itself is asleep and not running. Most disks will power themselves down by default, unless they are special kind of disk like the ones used in servers (Enterprise types). This can be rectified for normal disks by making edits to disk power options, I believe that it is under a utility known as “hdparm”, where you edit the amount of time it takes between no read/write and disk sleep. Unlike the SLP status, this one typically does mean that you are not plotting anything.

STP The process is stopped. You are not plotting at all. This one is pretty self explanatory.

[piotrkochan]

        if status == psutil.STATUS_RUNNING:
            return 'RUN'
        elif status == psutil.STATUS_SLEEPING:
            return 'SLP'
        elif status == psutil.STATUS_DISK_SLEEP:
            return 'DSK'
        elif status == psutil.STATUS_STOPPED:
            return 'STP'
        else:
            return self.proc.status()