Home | History | Annotate | Line # | Download | only in man4.sandpoint
satmgr.4 revision 1.1 
      1 .Dd Jan 26, 2011
      2 .Dt SATMGR 4 sandpoint
      3 .Os
      4 .Sh NAME
      5 .Nm satmgr
      6 .Nd
      7 driver for satellite processor, controlling power, front panel LEDs
      8 and buttons
      9 .Sh SYNOPSIS
     10 .Cd "satmgr0 at eumb? unit 0"
     11 .Cd "satmgr0 at eumb? unit 1"
     12 .Sh DESCRIPTION
     13 This driver provides an interface to the
     14 .Tn NAS
     15 builtin satellite microprocessor which controls the power, front
     16 panel LEDs and push buttons. Communication is performed through
     17 character sequences, whose definition and usage depend on the
     18 .Tn NAS
     19 product models.
     20 .Pp
     21 The device file
     22 .Pa /dev/satmgr
     23 can be written to control the satellite processor and the LEDs.
     24 Reading it will return single characters for button press events.
     25 This facility was designed to implement a
     26 .Tn NAS
     27 control
     28 .Tn CGI
     29 program.
     30 .Pp
     31 .Nm
     32 detects a soft power-off condition, which is triggered by holding
     33 the front panel power button pressed for several seconds.  This
     34 driver can optionally invoke
     35 .Xr powerd 8
     36 to get a finer control over the system shutdown procedure. It is
     37 capable of reporting a power-button-pressed event. Refer to the
     38 .Xr powerd 8
     39 manual section for more details.
     40 .Pp
     41 For
     42 .Tn "Kurobox/Linkstation"
     43 .Tn NAS
     44 products it also provides a way to
     45 toggle the system watchdog with the
     46 .Xr sysctl 8
     47 utility. The usage is:
     48 .Bd -literal -offset indent
     49 # sysctl -w machdep.satmgr.hwwdog_enable=1
     50 # sysctl -w machdep.satmgr.hwwdog_enable=0
     51 .Ed
     52 .Pp
     53 .Tn NAS
     54 products currently supported by
     55 .Xr satmgr 4 :
     56 .Bl -bullet -compact
     57 .It
     58 KuroBox
     59 .It
     60 Buffalo LinkStation
     61 .It
     62 Synology DiskStation
     63 .El
     64 .Sh FILES
     65 .Bl -tag -width /dev/satmgrX -compact
     66 .It Pa /dev/satmgr
     67 communication inferface to
     68 .Nm .
     69 .It Pa /dev/power
     70 event notify channel to
     71 .Xr powerd 8 .
     72 .El
     73 .Sh SEE ALSO
     74 .Xr powerd 8 
     75 .Sh HISTORY
     76 The
     77 .Nm
     78 driver
     79 first appeared in
     80 .Nx 6.0 .
     81