This command retrieves the free-busy calendar information for specified users. Free-busy calendar information indicates which times have been scheduled on the user's calendar. Free-busy calendar information does not include any details of the scheduled time.
Free-busy time is calculated for a time period that can be specified in one of three ways:
The default value of the duration parameter is taken from the ics.conf setting service.wcap.freebusyduration. The standard default is 60 days. This is the default taken if none of the time period parameters are passed in.
dtstart and dtend parameters
The absolute start and end times to use for this free-busy calculation. These parameters have no default values.
freebusybegin and freebusyend parameters.
The relative beginning and end times to include in the free-busy calculation. If these are specified with no value, the default is 30 for each.
If conflicting parameters are passed in, the duration parameter overrides the other two types.
For further information about how free-busy calendars are specified, see Free-Busy Calendars in Calendar Server WCAP