---
layout: doc
title: filesystem / rename
---
# rename

### NAME

    rename() - rename a file

### SYNOPSIS

    int rename( string src, string dst );

### DESCRIPTION

    Renames the file <src> to <dst>.

### RETURN VALUE

    rename() returns zero (0) to indicate success.  Nonzero indicates fail‐
    ure.

### SEE ALSO

    rm(3), rmdir(3), cp(3), link(3)

