Before and since filters documentation
@@ -57,6 +57,8 @@ The currently supported filters are:
* exited (int - the code of exited containers. Only useful with `--all`)
* status (created|restarting|running|paused|exited|dead)
* ancestor (`<image-name>[:<tag>]`, `<image id>` or `<image@digest>`) - filters containers that were created from the given image or a descendant.
+* before (container's id or name) - filters containers created before given id or name
+* since (container's id or name) - filters containers created since given id or name
* isolation (default|process|hyperv) (Windows daemon only)
@@ -163,6 +165,34 @@ in it's layer stack.
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
82a598284012 ubuntu:12.04.5 "top" 3 minutes ago Up 3 minutes sleepy_bose
+#### Before
+
+The `before` filter shows only containers created before the container with given id or name. For example,
+having these containers created:
+
+ $ docker ps
+ CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
+ 9c3527ed70ce busybox "top" 14 seconds ago Up 15 seconds desperate_dubinsky
+ 4aace5031105 busybox "top" 48 seconds ago Up 49 seconds focused_hamilton
+ 6e63f6ff38b0 busybox "top" About a minute ago Up About a minute distracted_fermat
+
+Filtering with `before` would give:
+
+ $ docker ps -f before=9c3527ed70ce
+ CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
+ 4aace5031105 busybox "top" About a minute ago Up About a minute focused_hamilton
+ 6e63f6ff38b0 busybox "top" About a minute ago Up About a minute distracted_fermat
+
+#### Since
+
+The `since` filter shows only containers created since the container with given id or name. For example,
+with the same containers as in `before` filter:
+
+ $ docker ps -f since=6e63f6ff38b0
+ CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
+ 9c3527ed70ce busybox "top" 10 minutes ago Up 10 minutes desperate_dubinsky
+ 4aace5031105 busybox "top" 10 minutes ago Up 10 minutes focused_hamilton
+
## Formatting
