# Libtmux_unix.Client.rename_session

- **Module:** Libtmux_unix
- **Package:** libtmux-unix
- **Language:** OCaml
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-ocaml/blob/205dfda49742592b479247049d186956e4a4cfe9/unix/libtmux_unix.mli#L308
- **Public owner:** Libtmux_unix
- **Page:** https://libtmux.org/en/ocaml/latest/reference/libtmux_unix-client-rename_session/

```
val rename_session :
  ?cancel:Cancellation.t ->
  t ->
  Libtmux.Session.target -> name:string -> (unit, Libtmux.Error.t) result
```

Set the session name, rejecting a conflicting existing name. Bound IDs remain usable; existing snapshots retain their captured names.

## Parameters

- `cancel?` (`Cancellation.t`)
- `arg1` (`t`)
- `arg2` (`Libtmux.Session.target`)
- `name` (`string`)

## tmux command

The tmux commands behind `rename_session`.

- [`rename-session`](/en/tmux/latest/manual/rename-session/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_rename_session_entry`](/en/tmux/latest/reference/c-variable-cmd_rename_session_entry/) (attribute)
- [`cmd_rename_session_exec`](/en/tmux/latest/reference/c-function-cmd-rename-session-c-cmd_rename_session_exec/) (function)

## In other ports

Rename a session

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Session.rename_session`](/en/py/latest/reference/libtmux-session-rename_session/) (method) |
| Ruby | [`LibTmux::Session#rename`](/en/ruby/latest/reference/libtmux-session-rename/) (method) |
| Lua | [`libtmux.Session:rename`](/en/lua/latest/reference/libtmux-session-rename/) (method) |
| Erlang | [`tmux_session:rename/2`](/en/erlang/latest/reference/tmux_session-rename-2/) (function) |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | [`session.Session.rename`](/en/ts/latest/reference/session-session-rename/) (method) |
| Rust | [`session.Session.rename`](/en/rs/latest/reference/session-session-rename/) (method) |
| Go | [`tmux.Session.Rename`](/en/go/latest/reference/tmux-session-rename/) (method) |
| Java | [`io.github.libtmux.Session.rename`](/en/java/latest/reference/io-github-libtmux-session-session-rename/) (method) |
| C# | [`LibTmux.Session.RenameAsync`](/en/csharp/latest/reference/libtmux-session-renameasync/) (method) |
| C++ | [`libtmux::Session::rename`](/en/cxx/latest/reference/libtmux-session-rename/) (method) |
| Swift | [`Server.rename(_:to:)`](/en/swift/latest/reference/server-rename(_-to-)/) (method) |
| Perl | [`LibTmux::Server::rename_session`](/en/perl/latest/reference/libtmux-server-rename_session/) (method). Explicit Server operation. Captured entities remain local observations; use a new snapshot to observe changes. |

No equivalent is recorded in PowerShell, Julia, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.