rndc halt -p behavior

[Doug Barton]

Jeremy C. Reed wrote:
> On Wed, 21 Jan 2009, Rich Goodson wrote:
> 
>> And I'm expected to know this, how?

Rich, you read into the text what you wanted it to say (as you
indicated in another message) but failed to try to understand what was
actually there. The behavior you're saying you thought the docs
described doesn't even make sense. "Ok, I stopped the server for you,
here is the pid it used to be running as." Huh? :)

> Just to clarify the documentation part:
> 
> 	Stop the server immediately.
> 
> Maybe we should just remove the "immediately" part.
> 
> Any suggestions would be appreciated.

rndc -h for 9.6.0-P1 reads:

  stop     Save pending updates to master files and stop the server.
  stop -p  Save pending updates to master files and stop the server
           reporting process id.
  halt     Stop the server without saving pending updates.
  halt -p  Stop the server without saving pending updates reporting
           process id.

You might be able to squeeze more meaning into it by saying, "Finish
updates to master files and shut down the server." And, "...server,
and report the pid of the named process." Arguably "shut down" implies
the beginning of a process rather than a single event, although what's
there now makes perfect sense to me.


hth,

Doug