Changeset 7715


Ignore:
Timestamp:
Jan 16, 2009, 1:03:33 AM (12 years ago)
Author:
charles
Message:

(trunk) add interface versioning to the RPC spec

Location:
trunk
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/rpc-spec.txt

    r7348 r7715  
    324324   "speed-limit-up-enabled"   | 'boolean'  true means enabled
    325325   "version"                  | string     long version string "$version ($revision)"
     326   "rpc-version"              | number     the current RPC API version
     327   "rpc-version-minimum"      | number     the minimum RPC API version supported
     328
     329   "rpc-version" indicates the RPC interface version supported by the RPC server.
     330   It is incremented when a new version of Transmission changes the RPC interface.
     331
     332   "rpc-version-minimum" indicates the oldest API supported by the RPC server.
     333   It is changes when a new version of Transmission changes the RPC interface
     334   in a way that is not backwards compatible.  There are no plans for this
     335   to be common behavior.
    326336
    3273374.1.1.  Mutators
     
    354364   
    355365
     3665.0.  Protocol Versions
     367
     368  The following changes have been made to the RPC interface:
     369
     370   RPC   | Release | Backwards |                |
     371   Vers. | Version | Compat?   | Method         | Description
     372   ------+---------+-----------+----------------+-------------------------------
     373   1     | 1.30    | n/a       | n/a            | Initial version
     374   ------+---------+-----------+----------------+-------------------------------
     375   2     | 1.34    | yes       | torrent-get    | new arg "peers"
     376   ------+---------+-----------+----------------+-------------------------------
     377   3     | 1.41    | yes       | torrent-get    | added "port" to "peers"
     378         |         |           | torrent-get    | new arg "downloaders"
     379         |         |           | session-get    | new arg "version"
     380         |         |           | torrent-remove | new method
     381   ------+---------+-----------+----------------+-------------------------------
     382   4     | 1.50    | yes       | session-get    | new arg "rpc-version"
     383         |         |           | session-get    | new arg "rpc-version-minimum"
     384   ------+---------+-----------+----------------+-------------------------------
     385
  • trunk/libtransmission/rpcimpl.c

    r7696 r7715  
    719719    tr_bencDictAddInt( d, "port", tr_sessionGetPeerPort( session ) );
    720720    tr_bencDictAddInt( d, "port-forwarding-enabled", tr_sessionIsPortForwardingEnabled( session ) );
     721    tr_bencDictAddInt( d, "rpc-version", 4 );
     722    tr_bencDictAddInt( d, "rpc-version-minimum", 1 );
    721723    tr_bencDictAddInt( d, "speed-limit-up", tr_sessionGetSpeedLimit( session, TR_UP ) );
    722724    tr_bencDictAddInt( d, "speed-limit-up-enabled", tr_sessionIsSpeedLimitEnabled( session, TR_UP ) );
Note: See TracChangeset for help on using the changeset viewer.