Defines RPC calls for IPv6 route changes and VRF registration.
This service declares both the Vrf Registration, as well as adding, deleting and getting IPv6 routes. All IPv6 addresses are encoded in network byte order.
Messages | |
| message | SLRoutev6 |
| IPv6 route. More... | |
| message | SLRoutev6Msg |
| List of routes for bulk download. More... | |
| message | SLRoutev6Res |
| IPv6 route result, uniquely identified by the Prefix/PrefixLen pair. More... | |
| message | SLRoutev6MsgRsp |
| IPv6 bulk route result status. More... | |
| message | SLRoutev6GetMsg |
| Used to retrieve route attributes. More... | |
| message | SLRoutev6GetMsgRsp |
| Gt Route message response. More... | |
| message | SLRoutev6NotifRoute |
| IPv6 Route notification. More... | |
| message | SLRoutev6Notif |
| IPv6 notification message. More... | |
| rpc SLRoutev6Oper::SLRoutev6GetNotifStream | ( | stream | SLRouteGetNotifMsg | ) |
Route Redistribution Operations.
This call is used to get a stream of route notifications. It can be used to get "push" notifications for route adds/updates/deletes. The caller must maintain the GRPC channel as long as there is interest in route notifications.
The call takes a stream of per-VRF notification requests. The success/failure of the notification request is relayed in the SLRouteNotifStatus followed by a Start marker, any routes if present, and an End Marker.
| rpc SLRoutev6Oper::SLRoutev6GlobalsGet | ( | SLRouteGlobalsGetMsg | ) |
Global Route operations.
Used to retrieve Global Route information
| rpc SLRoutev6Oper::SLRoutev6Op | ( | SLRoutev6Msg | ) |
Route operations.
SLRoutev6Msg.Oper = SL_OBJOP_ADD: Route add. Fails if the route already exists and is not stale. First ADD operation on a stale route is treated as implicit update and the route is no longer considered stale.
SLRoutev6Msg.Oper = SL_OBJOP_UPDATE: Route update. Create or update the route. The RPC implements replacement semantics, wherein if the route exists, all its attributes are replaced with values from the new message.
SLRoutev6Msg.Oper = SL_OBJOP_DELETE: Route delete. The route's key is enough to delete the object. Other attributes, if provided are ignored. Delete of a non-existant route is returned as success.
| rpc SLRoutev6Oper::SLRoutev6OpStream | ( | stream | SLRoutev6Msg | ) |
Stream Route operations.
SLRoutev6Msg.Oper = SL_OBJOP_ADD: Route add. Fails if the route already exists and is not stale. First ADD operation on a stale route is treated as implicit update and the route is no longer considered stale.
SLRoutev6Msg.Oper = SL_OBJOP_UPDATE: Route update. Create or update the route. The RPC implements replacement semantics, wherein if the route exists, all its attributes are replaced with values from the new message.
SLRoutev6Msg.Oper = SL_OBJOP_DELETE: Route delete. The route's key is enough to delete the object. Other attributes, if provided are ignored. Delete of a non-existant route is returned as success.
| rpc SLRoutev6Oper::SLRoutev6VrfRegOp | ( | SLVrfRegMsg | ) |
VRF registration operations.
SLVrfRegMsg.Oper = SL_REGOP_REGISTER: VRF registration: Sends a list of VRF registration messages and expects a list of registration responses. A client Must Register a VRF BEFORE routes can be added/modified in the associated VRF.
SLVrfRegMsg.Oper = SL_REGOP_UNREGISTER: VRF Un-registration: Sends a list of VRF un-registration messages and expects a list of un-registration responses. This can be used to convey that the client is no longer interested in these VRFs. All previously installed routes would be removed.
SLVrfRegMsg.Oper = SL_REGOP_EOF: VRF End Of File message. After Registration, the client is expected to send an EOF message to convey the end of replay of the client's known objects. This is especially useful under certain restart scenarios when the client and the server are trying to synchronize their Routes.
The VRF registration operations can be used by the client to synchronize routes with the device. When the client re-registers the VRF with the server using SL_REGOP_REGISTER, server marks routes as stale. Client then must reprogram routes it is interested in. When client sends SL_REGOP_EOF, any routes not reprogrammed are removed from the device.
The client must perform all operations (VRF registration, routes) from a single execution context.
| message SLRoutev6 |
IPv6 route.
Attributes | |
| bytes | Prefix = 1 |
| IPv6 Prefix 0:: - ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff. | |
| uint32 | PrefixLen = 2 |
| IPv6 prefix length [0-128]. | |
| SLRouteCommon | RouteCommon = 3 |
| Common route attributes. | |
| repeated SLRoutePath | PathList = 4 |
| For ADD or UPDATE operation, only one of PathList or SLPathGroupRefKey must be specified. More... | |
| oneof { | |
| SLPathGroupRefKey PathGroupKey = 5 | |
| Path group reference key. | |
| }; | |
| Reference to the Path Group for this route. More... | |
| oneof { ... } |
Reference to the Path Group for this route.
The attribute is oneof to allow for future extension.
| repeated SLRoutePath SLRoutev6::PathList = 4 |
For ADD or UPDATE operation, only one of PathList or SLPathGroupRefKey must be specified.
For DELETE, neither are required. List of route paths for this route. Specifying more than one path is allowed for ECMP/UCMP cases
| message SLRoutev6Msg |
List of routes for bulk download.
Attributes | |
| SLObjectOp | Oper = 1 |
| Route Object Operations. | |
| uint64 | Correlator = 2 |
| Correlator. More... | |
| string | VrfName = 3 |
| VRF name. | |
| repeated SLRoutev6 | Routes = 4 |
| List of routes for the VRF specified above. | |
| uint64 SLRoutev6Msg::Correlator = 2 |
Correlator.
This can be used to correlate replies with requests. The Server simply reflects this field back in the reply.
| message SLRoutev6Res |
IPv6 route result, uniquely identified by the Prefix/PrefixLen pair.
Attributes | |
| SLErrorStatus | ErrStatus = 1 |
| Corresponding error code. | |
| bytes | Prefix = 2 |
| IPv6 Prefix. | |
| uint32 | PrefixLen = 3 |
| IPv6 prefix length, [0-32]. | |
| message SLRoutev6MsgRsp |
IPv6 bulk route result status.
Attributes | |
| uint64 | Correlator = 1 |
| Correlator. More... | |
| string | VrfName = 2 |
| VRF name (matches the VRF name of the original operation) | |
| SLErrorStatus | StatusSummary = 3 |
| Summary result of the bulk operation (refer to enum SLErrorStatus) In general, the StatusSummary implies one of 3 things: More... | |
| repeated SLRoutev6Res | Results = 4 |
| In case of errors, this field indicates which entry in the bulk was erroneous. More... | |
| uint64 SLRoutev6MsgRsp::Correlator = 1 |
Correlator.
This can be used to correlate replies with requests. The Server simply reflects this field back in the reply.
| repeated SLRoutev6Res SLRoutev6MsgRsp::Results = 4 |
In case of errors, this field indicates which entry in the bulk was erroneous.
| SLErrorStatus SLRoutev6MsgRsp::StatusSummary = 3 |
Summary result of the bulk operation (refer to enum SLErrorStatus) In general, the StatusSummary implies one of 3 things:
| message SLRoutev6GetMsg |
Used to retrieve route attributes.
Attributes | |
| uint64 | Correlator = 1 |
| Correlator. More... | |
| string | VrfName = 2 |
| VRF name. More... | |
| bytes | Prefix = 3 |
| IPv6 Prefix. | |
| uint32 | PrefixLen = 4 |
| IPv6 prefix length, [0-32]. | |
| uint32 | EntriesCount = 5 |
| Number of entries requested. | |
| bool | GetNext = 6 |
| if GetNext is FALSE: request up to 'EntriesCount' entries starting from the key If GetNext is TRUE, or if the key exact match is not found: request up to 'EntriesCount' entries starting from the key's next GetNext does not get the routes in the next client | |
| uint64 SLRoutev6GetMsg::Correlator = 1 |
Correlator.
This can be used to correlate replies with requests. The Server simply reflects this field back in the reply.
| string SLRoutev6GetMsg::VrfName = 2 |
VRF name.
If the Key is not specified, then request up to the first 'EntriesCount' entries.
| message SLRoutev6GetMsgRsp |
Gt Route message response.
Attributes | |
| uint64 | Correlator = 1 |
| Correlator. More... | |
| bool | Eof = 2 |
| End Of File. More... | |
| string | VrfName = 3 |
| VRF name. | |
| SLErrorStatus | ErrStatus = 4 |
| Status of the Get operation. | |
| repeated SLRoutev6 | Entries = 5 |
| Returned entries as requested in the Get operation. More... | |
| uint64 SLRoutev6GetMsgRsp::Correlator = 1 |
Correlator.
This can be used to correlate replies with requests. The Server simply reflects this field back in the reply.
| repeated SLRoutev6 SLRoutev6GetMsgRsp::Entries = 5 |
Returned entries as requested in the Get operation.
if ErrStatus is SL_SUCCESS, Entries contains the info requested
| bool SLRoutev6GetMsgRsp::Eof = 2 |
End Of File.
When set to True, it indicates that the server has returned M, where M < N, of the original N requested Entries.
| message SLRoutev6NotifRoute |
| message SLRoutev6Notif |
IPv6 notification message.
Attributes | |
| SLNotifType | EventType = 1 |
| Event Type. | |
| oneof { | |
| SLErrorStatus ErrStatus = 2 | |
| case EventType == SL_EVENT_TYPE_ERROR: => This field carries error info, if any error occurs during notification stream setup. More... | |
| SLRouteNotifStatus NotifStatus = 3 | |
| case EventType == SL_EVENT_TYPE_STATUS: => This field carries the status of the GetNotifMsg request. More... | |
| SLRoutev6NotifRoute Route = 4 | |
| case EventType == SL_EVENT_TYPE_ROUTE: => This field carries the v6 route | |
| SLRouteNotifMarker Marker = 5 | |
| case EventType == SL_EVENT_TYPE_START_MARKER: case EventType == SL_EVENT_TYPE_END_MARKER: => This field carries the start marker and end marker per-VRF. More... | |
| SLVrfNotif Vrf = 6 | |
| case EventType == SL_EVENT_TYPE_VRF: | |
| }; | |
| Further info based on EventType. | |
| SLErrorStatus SLRoutev6Notif::ErrStatus = 2 |
case EventType == SL_EVENT_TYPE_ERROR: => This field carries error info, if any error occurs during notification stream setup.
| SLRouteNotifMarker SLRoutev6Notif::Marker = 5 |
case EventType == SL_EVENT_TYPE_START_MARKER: case EventType == SL_EVENT_TYPE_END_MARKER: => This field carries the start marker and end marker per-VRF.
| SLRouteNotifStatus SLRoutev6Notif::NotifStatus = 3 |
case EventType == SL_EVENT_TYPE_STATUS: => This field carries the status of the GetNotifMsg request.
