--- smf_state_to_string.3scf	Mon Oct 12 15:50:15 2009
+++ smf_state_to_string.3scf.new	Mon Oct 12 15:44:18 2009
@@ -6,7 +6,8 @@
      smf_enable_instance,		    smf_disable_instance,
      smf_refresh_instance,		    smf_restart_instance,
      smf_maintain_instance,		    smf_degrade_instance,
-     smf_restore_instance,  smf_get_state - administrative inter-
+     smf_restore_instance,  smf_get_state,   smf_state_to_string,
+     smf_state_from_string                - administrative inter-
      face to the Service Configuration Facility
 
 SYNOPSIS
@@ -29,6 +30,10 @@
 
      char *smf_get_state(const char *instance);
 
+     const char *smf_state_to_string(int32_t state_code);
+
+     Int32_t smf_state_from_string(const char *state);
+
 DESCRIPTION
      These functions provide administrative control over  service
      instances.	Using these functions, an administrative tool can
@@ -94,6 +99,25 @@
        #define SCF_STATE_STRING_ONLINE	       ((const char *)"online")
        #define SCF_STATE_STRING_DEGRADED       ((const char *)"degraded")
 
+     The smf_state_to_string() function returns a pointer to an
+     immutable string containing the state equivalent to
+     state_code. Possible state strings are defined as above.
+     Possible state codes are defined as following:
+
+       #define  SCF_STATE_UNINIT        0x00000001
+       #define  SCF_STATE_MAINT         0x00000002
+       #define  SCF_STATE_OFFLINE       0x00000004
+       #define  SCF_STATE_DISABLED      0x00000008
+       #define  SCF_STATE_ONLINE        0x00000010
+       #define  SCF_STATE_DEGRADED      0x00000020
+
+     The smf_state_from_string() function returns the value
+     equivalent to the string parameter state. Besides the
+     strings defined above, this function accepts the string
+     "all" as argument. In this case the returned value is:
+
+       #define  SCF_STATE_ALL           0x0000003F
+
 RETURN VALUES
      Upon    successful	   completion,	   smf_enable_instance(),
      smf_disable_instance(),		  smf_refresh_instance(),
@@ -104,6 +128,13 @@
      Upon successful completion, smf_get_state returns	an  allo-
      cated string. Otherwise, it returns NULL.
 
+     Upon successful completion smf_state_to_string returns a
+     pointer to a constant string. Otherwise, it returns NULL.
+
+     Upon successful completion smf_state_from_string returns the
+     macro value defined for the parameter state. Otherwise it
+     returns -1.
+
 ERRORS
      These functions will fail if: