Adds documentation for additional groups.

Signed-off-by: Mrunal Patel <mrunalp@gmail.com>

docs/reference/api/docker_remote_api.md

@@ -68,6 +68,10 @@ Running `docker rmi` emits an **untag** event when removing an image name.  The
 
 ### What's new
 
+**New!**
+The `hostConfig` option now accepts the field `GroupAdd`, which specifies a list of additional
+groups that the container process will run as.
+
 ## v1.19
 
 ### Full documentation

docs/reference/commandline/run.md

@@ -34,6 +34,7 @@ weight=1
       --entrypoint=""            Overwrite the default ENTRYPOINT of the image
       --env-file=[]              Read in a file of environment variables
       --expose=[]                Expose a port or a range of ports
+      --group-add=[]             Add additional groups to run as
       -h, --hostname=""          Container host name
       --help=false               Print usage
       -i, --interactive=false    Keep STDIN open even if not attached

docs/reference/run.md

@@ -737,6 +737,16 @@ weights of the two containers.
 > **Note:** The blkio weight setting is only available for direct IO. Buffered IO
 > is not currently supported.
 
+## Additional groups
+    --group-add: Add Linux capabilities
+
+By default, the docker container process runs with the supplementary groups looked
+up for the specified user. If one wants to add more to that list of groups, then
+one can use this flag:
+
+    $ docker run -ti --rm --group-add audio  --group-add dbus --group-add 777 busybox id
+    uid=0(root) gid=0(root) groups=10(wheel),29(audio),81(dbus),777
+
 ## Runtime privilege, Linux capabilities, and LXC configuration
 
     --cap-add: Add Linux capabilities