# LibTmux.rename_session

- **Module:** LibTmux
- **Package:** LibTmux
- **Language:** Julia
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-julia/blob/f3da513be1225d36d5854cd8db5972c01857578e/src/topology.jl#L279
- **Page:** https://libtmux.org/en/julia/latest/reference/libtmux-rename_session/

```
rename_session(
    connection::LibTmux.ControlConnection,
    target::LibTmux.SessionRef,
    name::AbstractString;
    kwargs...
)

rename_session(
    server::LibTmux.Server,
    target::LibTmux.SessionRef,
    name::AbstractString;
    kwargs...
)
```

Rename an exact object without expanding format text. tmux's name normalization rules still apply. Return the command result.

```julia
rename_session(server, target, name; kwargs...)
```

## Methods

### `rename_session` (overload 1)

```julia
rename_session(
    connection::LibTmux.ControlConnection,
    target::LibTmux.SessionRef,
    name::AbstractString;
    kwargs...
)
```

[Source](https://github.com/libtmux/libtmux-julia/blob/f3da513be1225d36d5854cd8db5972c01857578e/src/control_topology.jl#L151).

Rename an exact object without expanding format text. Names must be valid UTF-8 without control bytes; tmux's name normalization still applies. Return `ControlResult` after the pinned connection's completion fence.

```julia
rename_session(connection::ControlConnection, target, name; kwargs...)
```

### `rename_session` (overload 2)

```julia
rename_session(
    server::LibTmux.Server,
    target::LibTmux.SessionRef,
    name::AbstractString;
    kwargs...
)
```

[Source](https://github.com/libtmux/libtmux-julia/blob/f3da513be1225d36d5854cd8db5972c01857578e/src/topology.jl#L273).

## Parameters

- `connection` (`LibTmux.ControlConnection`) (for `rename_session(connection, target, name, kwargs)`)
- `target` (`LibTmux.SessionRef`)
- `name` (`AbstractString`)
- `kwargs`
- `server` (`LibTmux.Server`) (for `rename_session(server, target, name, kwargs)`)