TweetFollow Us on Twitter

AppleShare IP Additions

Volume Number: 15 (1999)
Issue Number: 2
Column Tag: ExplainIt

Crafting AppleShare IP Web and File Server Additions

by Erik Sea
Edited by Peter N Lewis

Using the AppleShare IP Web & File Server Control API

Server Additions - AppleShare IP Web & File

You're probably quite familiar with Mac OS APIs, functions, and controls. You've probably also run across AppleShare, and you've likely also used an AppleShare IP File Server. But I'll bet you didn't know that key pieces of AppleShare functionality are accessible to developers through a number of APIs. In this article, we'll only talk about the Web & File Server, but you can find out about other APIs, such as the AppleShare Registry and User Authentication Modules, by perusing the AppleShare IP SDK.

In this article, I'll go through the process of writing a simple little application (called a "server addition") that allows the user to control the W&F Server, and displays some server statistics. As I proceed, I'll pursue the occasional diversion that may inspire you but isn't directly related to the server addition I'm concocting here.

To use the code presented in this article, you'll need an AppleShare IP Web & File Server, and a copy of the latest version of the AppleShare IP SDK, which is available on the Mac OS SDK CD and on the Apple Developer web pages. While a few of these calls work with Macintosh File Sharing, the basic peer-to-peer version of AppleShare that ships with Mac OS (sometimes called Personal File Sharing), this article is focussed on the much more extensive developer API suite that is available under the full W&F Server.

Give Me Server Control

Although it is technically correct to view the Web & File Server as an application, in reality, when the server is installed on a machine it alters and extends the behavior of several parts of Mac OS. Once W&F is on a machine, you can control and monitor the server using API calls, just as you can make Mac OS API calls, whether the server is "serving" or not (although most calls are not useful when the server is not running and will simply return errors). In ASIP 6.1, there are roughly 29 API calls you can make, ranging from starting the server, to sending messages to connected users. You can also ask the server to tell you when things happen, such as when a user has connected or disconnected. The AppleShare Web & File Server also supports WebStar plugins.

The Server Control API consists of various parameter blocks used to set and retrieve information from the server. While it would take a lot of space to detail each of the various calls and parameters in this article, I've provided a brief summary in Table 1. If you want to know more on any of these, see the AppleShare IP SDK.

Table 1: Server Control Calls & Command Constants

SCStartServer                = 0   // Start the server
SCShutDown                   = 2   // Shut down the server
SCCancelShutDown             = 3   // Stop a shut down in progress
SCDisconnect                 = 4   // Disconnect a list of users
SCPollServer                 = 5   // Status: starting/running/shutting down
SCGetExpFldr                 = 6   // Info about a shared folder or volume
SCGetSetupInfo               = 7   // Get configuration info
SCSetSetupInfo               = 8   // Change configuration info
SCSendMessage                = 9   // Send message to user or users
SCGetServerStatus            = 10   // Time of last server change
SCInstallServerEventProc     = 11   // Installs a server event handler
SCRemoveServerEventProc      = 12   // Removes a server event handler
SCGetServerEventProc         = 13   // Retrieve a server event handler
SCServerVersion              = 14   // Version of AppleShare
SCSetCopyProtect             = 16   // Make file copy protected
SCClrCopyProtect             = 17   // Make file unprotected
SCDisconnectVolUsers         = 18   // Disconnect users from volumes
SCGetUserNameRec             = 19   // Retrieve connected user information
SCGetUserMountInfo           = 20   // How a user is using a volume
SCWakeServer                 = 21   // Starts a server that has been paused
SCSleepServer                = 22   // Pauses the server
SCGetCacheStats              = 23   // Cache size, utilization, hitcount
SCResetCache                 = 31   // Empty the file cache
SCGetExtUserNameRec          = 35   // Additional user information
SCServiceStateInfo           = 38   // Individual service states (FTP, etc.)
SCGetPlugInInfo              = 41   // Info about user's installed plugins
SCGetPlugInMimeType          = 42   // MIME type associated with a plugin
SCSetHistorySampleTime       = 43   // Time slice for server load monitoring
SCGetServerActivityHistory   = 44   // Server load percentages

Interestingly, the W&F Server's user interface is actually a separate application from the server, and it communicates with the server using these very same calls. Not all of the information available from these calls is exposed in the current user interface, and the possibilities for writing a server addition that displays additional information to the user are fairly wide-ranging - you could even replace the server's user interface entirely if you choose!

The application I'll be presenting is necessarily simplistic - just a modal dialog with a few bits of information and controls in it - but it provides a good foundation on which you could write a more advanced application, with more information and control organized as you see fit. And I hope you'll make it pretty and modeless!

ServerControl Demo Application

The user interface of the finished application is as seen in Figure 1. There's a button to flush the file server's data cache, some status text, and some counters. At the bottom of the screen, we have a histogram of server activity (gathered over a one day period), which shows maximum, minimum, or average usage levels, depending on what the user chooses.


Figure 1. ServerControl Demo main window.

We'll be using a modal dialog, in order to simplify the code (so I don't fill space with UI handling that's not directly related to the task at hand).

Determining if the Server is Installed

The first thing we need to do when our addition starts, after initializing all the appropriate toolbox routines, is ensure that an AppleShare IP W&F Server is installed. The easy method is to make a gestalt call, which will return an error if W&F is not installed, and the version number if it is (actually, this technique only works with 6.0 or later, but we're going to require 6.0 anyway so this is not a limitation). The source for this is in Listing 1.

Listing 1: Checking for Server and Version

extern Boolean
AppleShareIsInstalled (void) {

   Boolean   isInstalled = true;
   SInt32      asipVersion;
   OSErr      err;

   err = Gestalt (gestaltASIPFSVersion, &asipVersion);
   
   if ((err != noErr) || 
         (asipVersion < kMinimumAppleShareVersion)) {
      isInstalled = false;
   } // if

   return isInstalled;

} // AppleShareIsInstalled

Setting up the Window

Once we know that the server is there, and it's a suitable version, we can bring in the window, and handle it until closed. There's actually a bit more to it, of course. In order to count logins and file accesses, we need a server event handler (actually, we'll be counting each open of a file fork, so, if a file has both a data fork and a resource fork, a single open could be counted twice). We also need to set up the user item that draws the histogram and to ask the server to record history information using an appropriate time slice. The recommended time slice value is one sample every 84 seconds, so that with 1024 data points the server retains a full day's information. Changing the value may interfere with other programs that expect the value to be 84 seconds, so don't deviate without cause.

For the most part, we'll use global variables for communication between the server event handler, the dialog user item, and the modal dialog filter. Since AppleShare IP is PowerPC-only, we can write the addition as a PowerPC application, which means that we don't have to do anything special to use global variables.

Listing 2 shows these basic elements. We'll talk more about server event handlers and the server control calls we use in a bit.

Listing 2: Main.c

#define      kAllocateStorage         NULL
#define      kPlaceInFront            ((WindowPtr) (-1L))

// Global variables...

SInt16       gActivityType         = kWindowAvgRadioButtonIdx;
   // We map the radio group state to the current on value...
SInt32       gActiveUserCount       = 0;
   // Number of users currently logged on...
SInt32       gLoginCount             = 0;
   // Cumulative counter of login events...
SInt32       gAccessCount          = 0;
   // Cumulative counter of access events...
UInt16       gServerState          = kStateNotRunningIdx;
   // Map the server state to the string we'll display...
Boolean       gResetEnabled         = false;
   // The Reset button should be drawn enabled...
UInt32       gLastTimeServerPolled   = 0;
   // TimeStamp of the last time the server was called...
ServerHistoryRec gHistoryData;
   // Historical data last returned by the server...
ServerEventQEntry gServerEventQEntry;
   // Event handler queue entry...

// Support routines...

static void
Initialize (void) {

   // Initialize the managers we need...

   InitGraf (&qd.thePort);
   InitFonts ();
   InitWindows ();
   InitMenus ();
   TEInit ();
   InitDialogs (NULL);
   InitCursor ();

   // Initialize the data structures we'll use...

   gHistoryData.numDataPoints = 0;
   gHistoryData.historyLastSample = 0;

} // Initialize

// Main routine...

extern int
main (void) {

   DialogPtr      additionWindow;

   // Initialize the toolbox, then check for AppleShare.
   // If AppleShare is installed, go get the window,  set default control
   // and data structure values, install server event handler, and install
   // a dialog user item to draw the histogram.

   Initialize ();

   if (AppleShareIsInstalled ()) {
      additionWindow = GetNewDialog (kAdditionWindowRsrcID,
                               kAllocateStorage, kPlaceInFront);
      if (additionWindow != NULL) {
         InstallServerEventHandler ();
         SetServerTimeSlice (kOneDayTotalTimeSlice);
         SetUserItem (additionWindow, kWindowUserItemIdx,
                              DrawHistogram);
         SetDialogValues (additionWindow);
         HandleDialog (additionWindow);
         RemoveServerEventHandler ();      
      } // if
   } // if

   return 0;

} // main

Once we have the dialog in place, we need to keep it up to date. Listing 3, DialogStuff.c, contains all the basic routines for maintaining the UI. Of these routines, MonitorServerEvents and DrawHistogram merit some additional attention.

Keeping the Window Up-to-Date

Since this is a modal dialog, we ensure that the window is updated by making server control calls from the filterproc, MonitorServerEvents. The filterproc gets called fairly often but we don't want to bog down the server with all sorts of server control calls to get status and history information updated (particularly since we know the history information will only change every 84 seconds!), so we only poll every 10 seconds, which still allows us to see changes in the number of active users in a timely fashion. You might want to improve the logic here to further lighten the load on the server - nobody wants to run a server addition that impairs performance!

When the data changes, we force the histogram user item to completely redraw by invalidating its bounding rectangle from the filterproc. The user item, implemented by DrawHistogram, simply steps through the data points in the server history record, and uses them to draw vertical lines (bar chart style). For contrast, based on the radio button the user has chosen, the different activity levels (maximum, average, and minimum) are drawn in different colors. Since we allow the user to change which data to chart in the histogram, a redraw can also be forced from the HandleDialog routine, based on the radio button hit.

One quick note about how the history data are arranged by the server: the most recent sample is always in array position zero, with older data scrolling to higher positions and then disappearing. This may seem backwards, but makes sense if you envision the server history data as kind of like "activity EKG", with the recording needle fixed at the left hand side, and the tape moving to the right.

Listing 3: DialogStuff.c

#include    "ServerControlAddition.h"

extern pascal void
DrawHistogram (WindowPtr theDialog, SInt16 itemNo) {

   SInt16            itemType;
   Handle            itemHandle;
   Rect               itemRect;
   UInt16            drawItemIdx = 0;
   RGBColor         svColor;
   UInt16            drawValue;
   HistoryData*   currentPoint;
   HistoryData*   nextPoint;
   SInt16            horiz;
   SInt16            bottom;
   SInt16            top;

   // Get the item, frame it, inset by one; then draw a bar from
   // bottom to top for each defined data point, based on whether
   // we're showing minimum/maximum/average data. Now, because we
   // know that the area screen is half the number of available
   // data points (512 vs. 1024) and yet the height is twice as
   // tall (200 vs. 100 percent) we'll add pairs together. This
   // might make the last reading bogus if the number of
   // available data points is odd, but it will fix itself soon enough...
   
   GetDialogItem (theDialog, itemNo, &itemType,
         &itemHandle, &itemRect);
   FrameRect (&itemRect);
   InsetRect (&itemRect, 1, 1);
   EraseRect (&itemRect);
   GetForeColor (&svColor);
   
   while (drawItemIdx < gHistoryData.numDataPoints) {
      currentPoint = &gHistoryData.dataPoint[drawItemIdx];
      nextPoint = &gHistoryData.dataPoint[drawItemIdx+1];
      switch (gActivityType) {
         case kWindowMaxRadioButtonIdx:
            drawValue = currentPoint->dpMax +
                           nextPoint->dpMax;
            ForeColor (redColor);
            break;
         case kWindowMinRadioButtonIdx:
            drawValue = currentPoint->dpMin +
                           nextPoint->dpMin;
            ForeColor (blueColor);
            break;
         case kWindowAvgRadioButtonIdx:
         default:
            drawValue = currentPoint->dpAverage +
                           nextPoint->dpAverage;
            ForeColor (greenColor);
            break;
      } // switch
      horiz = itemRect.left + (drawItemIdx >> 1);
      bottom = itemRect.bottom - 1;
      top = bottom - drawValue;
      MoveTo (horiz, bottom);
      LineTo (horiz, top);
      drawItemIdx += 2;
   } // while

   RGBForeColor (&svColor);

} // DrawHistogram

extern void
HandleDialog (WindowPtr theDialog) {

   SInt16                  itemHit;
   ModalFilterUPP      modalFilterUPP;
   
   modalFilterUPP = NewModalFilterProc (MonitorServerEvents);

   do {
   
      ModalDialog (modalFilterUPP, &itemHit);
   
      switch (itemHit) {
      
         // For the radio buttons, we may need to update the
         // display immediately, but only if there's a change...
      
         case kWindowMaxRadioButtonIdx:
         case kWindowMinRadioButtonIdx:
         case kWindowAvgRadioButtonIdx:
            if (gActivityType != itemHit) {
               gActivityType = itemHit;
               InvalDialogItem (theDialog, kWindowUserItemIdx);
               SetDialogValues (theDialog);
            } // if
            break;
         
         // These are plain server control calls...
         
         case kWindowResetCacheButtonIdx:
            DoResetCache ();
            break;
         
         default:
            break;
         
      } // switch
   
   } while (itemHit != kStdOkItemIndex);

} // HandleDialog

extern void
SetDialogValues (DialogPtr additionWindow) {

   Str255      statusText;
   Str32      countText;

   // Update the radio group...

   TurnControlOn (additionWindow, gActivityType, true);
   if (gActivityType != kWindowMaxRadioButtonIdx) {
      TurnControlOn (additionWindow, kWindowMaxRadioButtonIdx,
                           false);
   } // if
   if (gActivityType != kWindowAvgRadioButtonIdx) {
      TurnControlOn (additionWindow, kWindowAvgRadioButtonIdx, 
                           false);
   } // if
   if (gActivityType != kWindowMinRadioButtonIdx) {
      TurnControlOn (additionWindow, kWindowMinRadioButtonIdx, 
                           false);
   } // if
   
   // Update the state text...
   
   GetIndString (statusText, kServerStateStringsRsrcID, 
                           gServerState);
   SetTextItem (additionWindow, kWindowStatusTextIdx, 
                           statusText);
   
   // Update the counters...
   
   NumToString (gActiveUserCount, countText);
   SetTextItem (additionWindow, kWindowActiveUsersTextIdx,
                         countText);
   NumToString (gLoginCount, countText);
   SetTextItem (additionWindow, kWindowLoginsTextIdx, 
                        countText);
   NumToString (gAccessCount, countText);
   SetTextItem (additionWindow, kWindowAccessesTextIdx, 
                        countText);
   
   // Update the button...
   
   SetButtonEnabled (additionWindow,
             kWindowResetCacheButtonIdx, gResetEnabled);
   
} // SetDialogValues

extern pascal Boolean
MonitorServerEvents (DialogPtr theDialog,
               EventRecord* theEvent, DialogItemIndex* itemHit) {

   // This filter gets called fairly often; if we make frequent server control
   // calls, we'll start impairing the performance of the server. So, let's 
   // only do it once every 10 seconds...

   UInt32      currentTime;
   UInt32      lastHistoryTime;

   GetDateTime (&currentTime);
   if (currentTime - gLastTimeServerPolled > 
                        kNumberOfSecondsBetweenPolls) {

      // Check for changes in the status of the server, and update
      // if necessary...

      UpdateServerStatus ();
      if (gServerState == kStateRunningIdx) {
         gResetEnabled = true;
      } else {
         gResetEnabled = false;
      } // if
      SetDialogValues (theDialog);
      
      // Since our UserItem will erase and redraw the entire histogram,
      // let's be sure it really changed before we force a redraw...
      
      lastHistoryTime = gHistoryData.historyLastSample;
      UpdateServerHistory ();
      if (lastHistoryTime != gHistoryData.historyLastSample) {
         InvalDialogItem (theDialog, kWindowUserItemIdx);
      } // if
   } // if
   
   return StdFilterProc (theDialog, theEvent, itemHit);

} // MonitorServerEvents

Talk to me, AppleShare IP

Now that we have enough of a UI in place to display what we want, and the mechanisms for keeping that UI updated, we need to write some code that actually talks to the server, updates our global variables, and populates our history buffer. Although there are 29 calls available, we're only going to need seven of them in this server addition.

Server control calls are parameter-block based, so, starting with a parameter block, you set various fields to different values, and that determines what the call actually is. The entry point is the routine ServerDispatchSync, which is defined in the header AppleShareFileServerControl.h, and implemented in the SDK library file SyncServerDispatch.c.

As can be seen in Listing 4, talking to the W&F Server is relatively straightforward: declare a parameter block, stuff in the required values, and then make the call, and retrieve the values. There are some additional things to consider for server event handlers, and we'll talk about those next.

Listing 4: Making Server Control Calls

#include    "ServerControlAddition.h"

extern void
SetServerTimeSlice (UInt32 secondsToWait) {

   OSErr                     err;
   SCParamBlockRec         pb;
   SetHistoryParamPtr   setHistoryParam;
   
   setHistoryParam = &pb.setHistoryParam;
   setHistoryParam->scCode = kSCSetHistorySampleTime;
   setHistoryParam->historySampleTime = secondsToWait;
   err = ServerDispatchSync (&pb);

} // SetServerTimeSlice

extern void
UpdateServerStatus (void) {

   OSErr                     err;
   SCParamBlockRec         pb;
   StatusParamPtr         statusParam;
   PollServerParamPtr   pollServerParam;

   // We get the number of connected users from the GetServerStatus call...

   statusParam = &pb.statusParam;
   statusParam->scNamePtr = NULL;
   statusParam->scCode = kSCGetServerStatus;
   err = ServerDispatchSync (&pb);
   if (err == noErr) {
      gActiveUserCount = statusParam->scNumSessions;
   } // if
   
   // And we get the state of the server from the PollServer call...
   
   pollServerParam = &pb.pollServerParam;
   pollServerParam->scCode = kSCPollServer;
   err = ServerDispatchSync (&pb);
   if (err == noErr) {
      switch (pollServerParam->scServerState) {
         case kSCPollRunning:
            gServerState = kStateRunningIdx;
            break;
         case kSCPollStartingUp:
            gServerState = kStateStartingIdx;
            break;
         case kSCPollSleeping:
            gServerState = kStateSleepingIdx;
            break;
         case kSCPollJustDisabled:
         case kSCPollDisabledErr:
            gServerState = kStateNotRunningIdx;
            break;
         default:
            gServerState = kStateShuttindDownIdx;
            break;
      } // switch
   } else {
      gServerState = kStateNotRunningIdx;
   } // if

} // UpdateServerStatus

extern void
UpdateServerHistory (void) {

   OSErr                     err;
   SCParamBlockRec         pb;
   GetHistoryParamPtr   getHistoryParam;
   
   getHistoryParam = &pb.getHistoryParam;
   getHistoryParam->scHistory = &gHistoryData;
   getHistoryParam->numDataPointsRequested = kSCMaxDataPoints;
   getHistoryParam->scCode = kSCGetServerActivityHistory;
   err = ServerDispatchSync (&pb);

} // UpdateServerHistory

extern void
InstallServerEventHandler (void) {

   OSErr                     err;
   SCParamBlockRec         pb;
   ServerEventParamPtr   serverEventParam;

   // Fill out the queue entry (requesting logons and opens), then
   // queue it...
   
   gServerEventQEntry.callBack = 
         NewServerEventHandlerProc (HandleServerEvents);
   gServerEventQEntry.serverEventMask = 0;
   gServerEventQEntry.afpCommandMask[0] = 0;
   gServerEventQEntry.afpCommandMask[1] = 0;
   gServerEventQEntry.serverControlMask = 0;
   SetAFPFlag (&gServerEventQEntry, afpLogin, 
                        true, false, true);
   SetAFPFlag (&gServerEventQEntry, afpOpenFork, 
                        false, true, true);

   serverEventParam = &pb.serverEventParam;
   serverEventParam->scSEQEntryPtr = 
                  (Ptr) &gServerEventQEntry;
   serverEventParam->scCode = kSCInstallServerEventProc;
   err = ServerDispatchSync (&pb);

} // InstallServerEventHandler

extern void
RemoveServerEventHandler (void) {

   OSErr                     err;
   SCParamBlockRec         pb;
   ServerEventParamPtr   serverEventParam;

   serverEventParam = &pb.serverEventParam;
   serverEventParam->scSEQEntryPtr = 
               (Ptr) &gServerEventQEntry;
   serverEventParam->scCode = kSCRemoveServerEventProc;
   err = ServerDispatchSync (&pb);

} // RemoveServerEventHandler

extern void
DoResetCache (void) {

   OSErr                     err;
   SCParamBlockRec         pb;
   ResetCacheParamPtr   resetCacheParam;
   
   resetCacheParam = &pb.resetCacheParam;
   resetCacheParam->scCode = kSCResetCache;
   resetCacheParam->bitmap = kSCShrinkAllCaches;
   err = ServerDispatchSync (&pb);

} // DoResetCache

Handling Server Events

Probably the most complicated part of the W&F API suite is in server event handling. An application (or really, any piece of code) can register to receive notifications of different kinds of events. You can receive server control event notification (lets you know when someone makes a server control call). You can receive server events (such things as when a CD has been inserted and has become sharable). And you can receive AFP events - those relating to AppleShare clients: logons, opens, closes, reads, writes - you name it. A complete list can be found in the AppleShare IP SDK, with explanations and sample code on how to set the server event block so that you get called for the events you're interested in.

For our addition, we're installing a handler that looks at two AFP events: afpLogin and afpOpenFork. You can receive event notification either before or after it has executed; if you receive the event after it has executed, you'll know what the result of the call was (for the most part, whether it succeeded or failed).

The most important part about writing a server event handler is recognizing that the server calls such handlers immediately, regardless of the state of the machine. This means that you probably don't have access to the toolbox or other routines you might need, and, just as importantly, because the server is in the middle of doing something (such as servicing a user request), your event handler should do the minimum amount of work possible. The typical strategy is to have your handler quickly queue server event records in memory you've allocated earlier, and then process those queued records in your main event loop, when you can do what you please. The SDK shows how to do this in detail.

Another thing to be careful about is not to modify server event data "in place", because, very often, the data in the server event record points to live data in the server itself, and modifying it could adversely affect the server's operation, and the server may become displeased with you. Thankfully, in this server addition, all we need to do is count events, so there is no need to queue things up - just increment the appropriate counter and continue. Listing 5 completes our application with the routines to set up the server event handler and the event handler itself.

Listing 5: Server Event Handling

extern pascal void
HandleServerEvents (ServerEventQEntry* queueEntry,
                  ExtendedServerEventRecord* event) {

   // Since this is probably not main event time, there's limits on
   // what we can do.  However, it should be safe to increment counters,
   // based on which afp command it is...
   
   if (event->eventNumber == kSCStartAFPRequestEvt) {
      switch (event->afpCommand) {
         case afpLogin:
            gLoginCount += 1;
            break;
         case afpOpenFork:
            gAccessCount += 1;
            break;
         default:
            break;
      } // switch
   } // if

} // HandleServerEvents

extern void
SetEventFlag (ServerEventQEntry* queueEntry,
         UInt32 whichEvent, Boolean onOff) {

   UInt32 maskValue = 0x1 << whichEvent;

   if (onOff) {
      queueEntry->serverEventMask |= maskValue;
   } else {
      queueEntry->serverEventMask &= ~maskValue;
   } // if

} // SetEventFlag

extern void
SetAFPFlag (ServerEventQEntry* queueEntry, UInt32 whichEvent,
         Boolean inDo, Boolean inReply, Boolean onOff) {

   UInt32 maskValue0 = 0;
   UInt32 maskValue1 = 0;
   
   // Special case of AddIcon gets remapped to bit 0.
   if (whichEvent == afpAddIcon) {
      whichEvent = 0;
   } // if
   
   if (whichEvent >= 32) {
      maskValue0 = 1 << (whichEvent % 32);
   } else {
      maskValue1 = 1 << whichEvent;
   } // if
   
   if (onOff) {
      queueEntry->afpCommandMask[0] |= maskValue0;
      queueEntry->afpCommandMask[1] |= maskValue1;
   } else {
      queueEntry->afpCommandMask[0] &= ~maskValue0;
      queueEntry->afpCommandMask[1] &= ~maskValue1;
   } // if
   
   // Set the appropriate Event flag(s) so this actually gets called.
   
   if (inDo) {
      SetEventFlag (queueEntry, kSCStartAFPRequestEvt, onOff);
   } // if
   if (inReply) {
      SetEventFlag (queueEntry, kSCStartAFPRequestEvt, onOff);
   } // if

} // SetAFPFlag

Go Write a Server Addition

I hope that this brief exposure to server control and event handling for the AppleShare IP Web & File Server has been illuminating. There are literally hundreds of events that you could process in new and different ways, and server information that you can expose to the user. Several commercial products have been written using these APIs, and AppleShare IP users are always looking for additional tools to help them better administer their servers.

With a bit of imagination, you could come up with a piece of software that fills a void or expands the usefulness of the world's easiest-to-use Web & File Server.

Happy controlling.

Related Links

http://www.apple.com/appleshareip/


Erik Sea joined the AppleShare IP team at Apple in March, 1998, as the Engineering Lead for the File Server (versions 6.0 and 6.1). Before that, he worked in the PowerBook group on such products as Apple Location Manager and its friends. When not busy coding, he can be found herding his free-range slinky collection. You can reach Erik at sea@apple.com.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Yasu 3.0.3 - System maintenance app; per...
Yasu was created with System Administrators who service large groups of workstations in mind, Yasu (Yet Another System Utility) was made to do a specific group of maintenance tasks quickly within a... Read more
MYStuff Pro 2.0.26 - $39.99
MYStuff Pro is the most flexible way to create detail-rich inventories for your home or small business. Add items to MYStuff by dragging and dropping existing information, uploading new images, or... Read more
MarsEdit 3.7.8 - Quick and convenient bl...
MarsEdit is a blog editor for OS X that makes editing your blog like writing email, with spell-checking, drafts, multiple windows, and even AppleScript support. It works with with most blog services... Read more
Apple iBooks Author 2.5 - Create and pub...
Apple iBooks Author helps you create and publish amazing Multi-Touch books for iPad. Now anyone can create stunning iBooks textbooks, cookbooks, history books, picture books, and more for iPad. All... Read more
TunnelBear 3.0.1 - Subscription-based pr...
TunnelBear is a subscription-based virtual private network (VPN) service and companion app, enabling you to browse the internet privately and securely. Features Browse privately - Secure your data... Read more
ExpanDrive 5.4.0 - Access cloud storage...
ExpanDrive builds cloud storage in every application, acts just like a USB drive plugged into your Mac. With ExpanDrive, you can securely access any remote file server directly from the Finder or... Read more
Opera 40.0.2308.62 - High-performance We...
Opera is a fast and secure browser trusted by millions of users. With the intuitive interface, Speed Dial and visual bookmarks for organizing favorite sites, news feature with fresh, relevant content... Read more
Apple iOS 10.0.2 - The latest version of...
iOS 10 is the biggest release of iOS ever. A massive update to Messages brings the power of the App Store to your conversations and makes messaging more personal than ever. Find your route with... Read more
Herald 7.0 - Notification plugin for Mai...
Note: Versions 2.1.3 (for OS X 10.7), 3.0.6 (for OS X 10.8), 4.0.8 (for OS X 10.9), 5.0.2 (for OS X 10.10), and 6.0.3 (for OS X 10.11) are no longer supported by the developer. Herald is a... Read more
Postbox 5.0.2 - Powerful and flexible em...
Postbox is a new email application that helps you organize your work life and get stuff done. It has all the elegance and simplicity of Apple Mail, but with more power and flexibility to manage even... Read more

How to build and care for your team in D...
Before you hit the trail and become a dog sledding legend, there’s actually a fair bit of prep work to be done. In Dog Sled Saga, you’re not only racing, you’re also building and caring for a team of furry friends. There’s a lot to consider—... | Read more »
How to win every race in Dog Sled Saga
If I had to guess, I’d say Dog Sled Saga is the most adorable racing game on the App Store right now. It’s a dog sled racing sim full of adorable, loyal puppies. Just look at those fluffy little tails wagging. Behind that cute, pixelated facade is... | Read more »
Let the war games commence in Gunship Ba...
Buzz Lightyear famously said, “This isn’t flying, this is falling – with style!” In the case of Gunship Battle: Second War, though, this really is flying - with style! The flight simulator app from Joycity puts you in control of 20 faithfully... | Read more »
How to get a high score in Fired Up
Fired Up is Noodlecake Games’ high score chasing, firefighting adventure. You take control of a wayward firefighter who propels himself up the side of a highrise with blasts of water. Sound silly? It is. It’s also pretty difficult. You can’t... | Read more »
NBA 2K17 (Games)
NBA 2K17 1.0 Device: iOS iPhone Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: Following the record-breaking launch of NBA 2K16, the NBA 2K franchise continues to stake its claim as the most authentic sports video... | Read more »
Dog Sled Saga (Games)
Dog Sled Saga 1.0.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.1 (iTunes) Description: A game by Dan + Lisa As a rookie musher, foster a dogsledding team whose skills will grow if they're treated right. Week by... | Read more »
60 Seconds! Atomic Adventure (Games)
60 Seconds! Atomic Adventure 1.2 Device: iOS Universal Category: Games Price: $2.99, Version: 1.2 (iTunes) Description: 60 Seconds! is a dark comedy atomic adventure of scavenge and survival. Collect supplies and rescue your family... | Read more »
Tons of Bullets! (Games)
Tons of Bullets! 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Tons of BulletsA retro 2D pixel platformer infused with tons of bullets and tons of features!Fight as Kenji the Ninja and... | Read more »
Sorcery! 4 (Games)
Sorcery! 4 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: *** PLEASE NOTE: Sorcery! 4 requires a minimum of iPad 3 or iPhone 4 *** An epic adventure through a cursed citadel of monsters,... | Read more »
Building the perfect Animation Throwdown...
Animation Throwdown is a casual card game full of plenty of inside jokes from some of your favorite cartoons. It’s accessible as far as card games go, but that’s not to say that it hands your victories to you easily. There’s quite a bit that goes... | Read more »

Price Scanner via MacPrices.net

Duplicate Sweeper Free On Mac App Store For O...
To celebrate the launch of Apple’s latest macOS Sierra, Stafford, United Kingdom based Wide Angle Software has announced that its duplicate file finder software, Duplicate Sweeper, is now available... Read more
13-inch Retina MacBook Pros on sale for up to...
B&H Photo has 13″ Retina Apple MacBook Pros on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1174.99 $125 off MSRP - 13... Read more
Evidence Surfaces Pointing To New A10X Chip F...
Citing a job description for a Project Lead position at Apple’s Austin, Texas engineering labs, Motley Fool’s Ashraf Eassa deduces that development is progressing well on Apple’s next-generation in-... Read more
Check Print’R for macOS Allows Anyone to Easi...
Delaware-based Match Software has announced the release and immediate availability of Check Print’R 3.21, an important update to their easy-to-use check printing application for macOS. Check Print’R... Read more
Apple refurbished 11-inch MacBook Airs availa...
Apple has Certified Refurbished 11″ MacBook Airs (the latest models), available for up to $170 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is... Read more
Apple refurbished 15-inch Retina MacBook Pros...
Apple has Certified Refurbished 2015 15″ Retina MacBook Pros available for up to $380 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 15″ 2... Read more
Major Version 5 Release Of Free myTuner Radio...
AppGeneration Software has announced the release of myTuner Radio 5.0.1, an important update to their live radio app for iOS and Android platforms. With myTuner Radio, you can listen to more than 30,... Read more
TheAppStore Searches And Filters iOS And macO...
Boston based InchWest has announced the official launch of TheAppStore, a free web based service that lets users search iOS and Mac apps on the web without iTunes or the App store. TheAppStore... Read more
2TB Time Capsule on sale for $199, save $100
Amazon has 2TB Apple Time Capsules on sale for $199 including free shipping. Their price is $100 off MSRP. Choose Amazon as the seller when making your purchase, rather than a third party seller. Read more
12-inch 1.2GHz Rose Gold Retina MacBook on sa...
Amazon.com has the 2016 12″ 1.2GHz Rose Gold Retina MacBook on sale for $1254.02 including free shipping. Their price is $345 off MSRP, and it’s the lowest price available for this model from any... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
US- *Apple* Store Leader Program - Apple (Un...
…Summary Learn and grow as you explore the art of leadership at the Apple Store. You'll master our retail business inside and out through training, hands-on Read more
Senior *Apple* Administrator - Pratt Instit...
POSITION SUMMARY: Directs the coordination and standardization of campus-wide Apple systems, including planning, analysis and implementation of Apple -related Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.