gistfile1.txt

DBus API would need at least:

/* interface per machine and one per container */
interface com.redhat.SubscriptionManager.Machine {
    properties:
        /* enumerated value, string or int */
        readonly ? RegistrationStatus;
        
        /* possibly needed? */
        readonly s SystemName;
        
        /* list of object paths pointing to Subscription instances below */
        readonly ao AttachedSubscriptions;
        
        /* list of object paths pointing to Subscription instances */   
        readonly ao PossibleSubscriptions;
        
        /* list of object paths pointing to Product instances */
        readonly ao InstalledProducts;
        
        /* display string for passing on to Red Hat during support call */
        readonly s AccountName;
        
        /* ... other properties? */
    methods:
        Register (in s server_url,
                  /* optional activationkey  */
                  in v credentials, /* user password is tuple (ss) */
                  in s system_name,
                  in a{sv} options);
        
        Unregister (in a{sv} options);
        
        /* attach likely needs a Pool */
        Attach (in o subscription);
        
        /* "Remove" in cli subcommand terms
             We can have multiple Entitlements for a Subscription.
        Remove (in o entitlement);
        */
        Detach (in o subscription);
    signals:
        /* the usual PropertiesChanged */
};
/* interface per subscription, attached or not, known about */
interface com.redhat.SubscriptionManager.Subscription {
    properties:
        /* Readable displayable name */
        readonly s SubscriptionName;
        
        /* seconds since epoch */
        readonly t StartDate;
        readonly t ExpiryDate;
        
        /* How many of the instances of subscription remain, -1 = unknown */
        readonly i InstancesRemaining;
        
        /* Status detail "reasons"  ("Only supports 1 of 2 sockets."), though
          that's really an Entitlement attr */
        /* ... other properties? */
    signals:
        /* the usual PropertiesChanged */
};
/* interface per product that subscription manager knows about */
interface com.redhat.SubscriptionManager.Product {
    properties:
        /* Readable display name */
        readonly s ProductName;
        readonly s Architecture;
        /* ... other properties, version? ... */
    signals:
        /* the usual PropertiesChanged */
};