Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions apis/OCIContainer/IOCIContainer.h
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ struct EXTERNAL IOCIContainer : virtual public Core::IUnknown {
// @text onContainerStopped
virtual void OnContainerStopped(const string& containerId, const string& name) {}

// @brief Notifies failure in container execution
// @brief Notifies failure in container execution, Only triggered for states start, stop, hibernate, wakeup.
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The word "Only" should not be capitalized mid-sentence. It should be "only".

Suggested change
// @brief Notifies failure in container execution, Only triggered for states start, stop, hibernate, wakeup.
// @brief Notifies failure in container execution, only triggered for states start, stop, hibernate, wakeup.

Copilot uses AI. Check for mistakes.
// @text onContainerFailed
virtual void OnContainerFailed(const string& containerId, const string& name, uint32_t error) {}
Comment on lines +58 to 60
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each event must include @param annotations for each parameter to describe their purpose. Missing @param tags for containerId, name, and error parameters.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

Expand All @@ -71,84 +71,84 @@ struct EXTERNAL IOCIContainer : virtual public Core::IUnknown {
/** Unregister notification interface */
virtual Core::hresult Unregister(INotification *notification) = 0;

/** Provide list of containers */
// @brief Provide list of containers
// @text listContainers
// @param containers - out/json - string
virtual Core::hresult ListContainers(string& containers /* @out @opaque */, bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +74 to 77
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. These descriptions will be included in the generated markdown documentation. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Get the information about container */
// @brief Get the information about container
// @text getContainerInfo
// @param containerId Identifier of container
virtual Core::hresult GetContainerInfo(const string& containerId , string& info /* @out @opaque */, bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +79 to 82
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Get the state of container */
// @brief Get the state of container
// @text getContainerState
// @param containerId Identifier of container
virtual Core::hresult GetContainerState(const string& containerId , ContainerState& state /* @out */, bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +84 to 87
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Start the container from bundle */
// @brief Start the container from bundle
// @text startContainer
// @param containerId Identifier of container
// @param bundlePath path of application bundle
// @param command(optional) command to run in container
// @param westerosSocket(optional) Westeros socket container need to connect
virtual Core::hresult StartContainer(const string& containerId , const string& bundlePath , const string& command , const string& westerosSocket , int32_t& descriptor /* @out */, bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +89 to 95
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Start the container from dobby specification */
// @brief Start the container from dobby specification
// @text startContainerFromDobbySpec
// @param containerId Identifier of container
// @param dobbySpec dobby specification as json string
// @param command(optional) command to run in container
// @param westerosSocket(optional) Westeros socket container need to connect
virtual Core::hresult StartContainerFromDobbySpec(const string& containerId , const string& dobbySpec , const string& command , const string& westerosSocket , int32_t& descriptor /* @out */, bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +97 to 103
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Stop the container */
// @brief Stop the container
// @text stopContainer
// @param containerId Identifier of container
// @param force(optional) Metion forceful or graceful termination of container
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling error: "Metion" should be "Mention".

Suggested change
// @param force(optional) Metion forceful or graceful termination of container
// @param force(optional) Mention forceful or graceful termination of container

Copilot uses AI. Check for mistakes.
virtual Core::hresult StopContainer(const string& containerId , bool force , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +105 to 109
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Pause the container */
// @brief Pause the container
// @text pauseContainer
// @param containerId Identifier of container
virtual Core::hresult PauseContainer(const string& containerId , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +111 to 114
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Resume the container */
// @brief Resume the container
// @text resumeContainer
// @param containerId Identifier of container
virtual Core::hresult ResumeContainer(const string& containerId , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +116 to 119
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Hibernate the container */
// @brief Hibernate the container
// @text hibernateContainer
// @param containerId Identifier of container
virtual Core::hresult HibernateContainer(const string& containerId , const string& options , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +121 to 124
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Wakeup the container */
// @brief Wakeup the container
// @text wakeupContainer
// @param containerId Identifier of container
virtual Core::hresult WakeupContainer(const string& containerId , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +126 to 129
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Execute the command in container */
// @brief Execute the command in container
// @text executeCommand
// @param containerId Identifier of container
// @param options(optional) options to be passed to command
// @param command command to run in container
virtual Core::hresult ExecuteCommand(const string& containerId , const string& options , const string& command , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +131 to 136
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** update container properties */
// @brief Update container properties
// @text annotate
// @param containerId Identifier of container
// @param key name of property
// @param value property data
virtual Core::hresult Annotate(const string& containerId , const string& key , const string& value , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +138 to 143
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Remove container property */
// @brief Remove container property
// @text removeAnnotation
// @param containerId Identifier of container
// @param key name of property
virtual Core::hresult RemoveAnnotation(const string& containerId , const string& key , bool& success /* @out */, string& errorReason /* @out */) = 0;
Comment on lines +145 to 149
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Documentation Tags Guidelines, each method must include @retval tags to describe each return code associated with the function. The method is missing @retval tags.

Refer: https://github.com/rdkcentral/entservices-apis/blob/develop/.github/instructions/api_headers.instructions.md#documentation-tags-guidelines

Copilot generated this review using guidance from repository custom instructions.

/** Mount a path in container */
// @brief Mount a path in container
// @text mount
// @param containerId Identifier of container
// @param source path source to mount
Expand All @@ -157,7 +157,7 @@ struct EXTERNAL IOCIContainer : virtual public Core::IUnknown {
// @param options options for mounting
virtual Core::hresult Mount(const string& containerId , const string& source , const string& target , const string& type , const string& options , bool& success /* @out */, string& errorReason /* @out */) = 0;

/** Unmount a path in container */
// @brief Unmount a path in container
// @text unmount
// @param containerId Identifier of container
// @param target path to unmount from container
Expand Down
64 changes: 32 additions & 32 deletions docs/apis/OCIContainer.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,26 +47,26 @@ OCIContainer interface methods:

| Method | Description |
| :-------- | :-------- |
| [annotate](#annotate) | |
| [executeCommand](#executeCommand) | |
| [getContainerInfo](#getContainerInfo) | |
| [getContainerState](#getContainerState) | |
| [hibernateContainer](#hibernateContainer) | |
| [listContainers](#listContainers) | |
| [mount](#mount) | |
| [pauseContainer](#pauseContainer) | |
| [removeAnnotation](#removeAnnotation) | |
| [resumeContainer](#resumeContainer) | |
| [startContainer](#startContainer) | |
| [startContainerFromDobbySpec](#startContainerFromDobbySpec) | |
| [stopContainer](#stopContainer) | |
| [unmount](#unmount) | |
| [wakeupContainer](#wakeupContainer) | |
| [annotate](#annotate) | Update container properties |
| [executeCommand](#executeCommand) | Execute the command in container |
| [getContainerInfo](#getContainerInfo) | Get the information about container |
| [getContainerState](#getContainerState) | Get the state of container |
| [hibernateContainer](#hibernateContainer) | Hibernate the container |
| [listContainers](#listContainers) | Provide list of containers |
| [mount](#mount) | Mount a path in container |
| [pauseContainer](#pauseContainer) | Pause the container |
| [removeAnnotation](#removeAnnotation) | Remove container property |
| [resumeContainer](#resumeContainer) | Resume the container |
| [startContainer](#startContainer) | Start the container from bundle |
| [startContainerFromDobbySpec](#startContainerFromDobbySpec) | Start the container from dobby specification |
| [stopContainer](#stopContainer) | Stop the container |
| [unmount](#unmount) | Unmount a path in container |
| [wakeupContainer](#wakeupContainer) | Wakeup the container |

<a id="annotate"></a>
## *annotate*


Update container properties

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -126,7 +126,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 0, "met
<a id="executeCommand"></a>
## *executeCommand*


Execute the command in container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -186,7 +186,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 1, "met
<a id="getContainerInfo"></a>
## *getContainerInfo*


Get the information about container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -244,7 +244,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 2, "met
<a id="getContainerState"></a>
## *getContainerState*


Get the state of container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -302,7 +302,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 3, "met
<a id="hibernateContainer"></a>
## *hibernateContainer*


Hibernate the container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -360,7 +360,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 4, "met
<a id="listContainers"></a>
## *listContainers*


Provide list of containers

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -412,7 +412,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 5, "met
<a id="mount"></a>
## *mount*


Mount a path in container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -476,7 +476,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 6, "met
<a id="pauseContainer"></a>
## *pauseContainer*


Pause the container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -532,7 +532,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 7, "met
<a id="removeAnnotation"></a>
## *removeAnnotation*


Remove container property

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -590,7 +590,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 8, "met
<a id="resumeContainer"></a>
## *resumeContainer*


Resume the container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -646,7 +646,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 9, "met
<a id="startContainer"></a>
## *startContainer*


Start the container from bundle

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -710,7 +710,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 10, "me
<a id="startContainerFromDobbySpec"></a>
## *startContainerFromDobbySpec*


Start the container from dobby specification

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -774,7 +774,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 11, "me
<a id="stopContainer"></a>
## *stopContainer*


Stop the container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -832,7 +832,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 12, "me
<a id="unmount"></a>
## *unmount*


Unmount a path in container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -890,7 +890,7 @@ curl -H 'content-type:text/plain;' --data-binary '{"jsonrpc": 2.0, "id": 13, "me
<a id="wakeupContainer"></a>
## *wakeupContainer*


Wakeup the container

### Events
Event details will be updated soon.
Expand Down Expand Up @@ -956,15 +956,15 @@ OCIContainer interface events:

| Event | Description |
| :-------- | :-------- |
| [onContainerFailed](#onContainerFailed) | Notifies failure in container execution |
| [onContainerFailed](#onContainerFailed) | Notifies failure in container execution, Only triggered for states start, stop, hibernate, wakeup. |
| [onContainerStarted](#onContainerStarted) | Notifies container is started |
| [onContainerStateChanged](#onContainerStateChanged) | Notifies state change of container |
| [onContainerStopped](#onContainerStopped) | Notifies container is stopped |

<a id="onContainerFailed"></a>
## *onContainerFailed*

Notifies failure in container execution
Notifies failure in container execution, Only triggered for states start, stop, hibernate, wakeup.

### Parameters
| Name | Type | Description |
Expand Down
Loading