aboutsummaryrefslogtreecommitdiffstats
path: root/man/bolt-down.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/bolt-down.1')
-rw-r--r--man/bolt-down.142
1 files changed, 42 insertions, 0 deletions
diff --git a/man/bolt-down.1 b/man/bolt-down.1
new file mode 100644
index 0000000..5a331d4
--- /dev/null
+++ b/man/bolt-down.1
@@ -0,0 +1,42 @@
+.Dd February 12, 2026
+.Dt BOLT-DOWN 1
+.Os
+.Sh NAME
+.Nm bolt-down
+.Nd revert migrations against the database
+.Sh SYNOPSIS
+.Nm bolt down
+.Op Fl v Ar version
+.Op Fl -version Ar version
+.Sh DESCRIPTION
+.Nm
+reverts applied migrations from the database. Migrations are reverted in
+reverse dependency order.
+.Pp
+By default, all applied migrations are reverted. Use the
+.Fl v
+option to revert migrations down to and including a specific version.
+.Pp
+Each migration runs within a transaction by default, ensuring that if any
+statement fails, the entire revert is rolled back. See
+.Xr bolt-execution 7
+for details on transaction behavior.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl v Ar version , Fl -version Ar version
+Revert migrations down to and including the specified version.
+.El
+.Sh EXIT STATUS
+.Nm
+exits 0 on success, and >0 if an error occurs.
+.Sh EXAMPLES
+Revert all applied migrations:
+.Dl $ bolt down
+.Pp
+Revert migrations down to a specific version:
+.Dl $ bolt down -v 20240316145038
+.Sh SEE ALSO
+.Xr bolt 1 ,
+.Xr bolt-status 1 ,
+.Xr bolt-up 1 ,
+.Xr bolt-execution 7