---
name: "gfs_unlink_section"
section: "3"
platform: "linux"
package: "libgfarm-dev"
version: "2.4.1-1.1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/gfs_unlink_section"
---

# gfs\_unlink\_section(3)

delete a file

## NAME

gfs\_unlink\_section - delete a file

## SYNOPSIS

**#include \<gfarm/gfarm.h\>**

**char \*gfs\_unlink\_section (char \*** *gfarm\_url***, char \*** *section***);**

## DESCRIPTION

**gfs\_unlink\_section()** deletes the file section whose name is the string specifiedby *gfarm\_url* and *section*.

## RETURN VALUES

- **NULL**

  The function terminated successfully.

- **GFARM\_ERR\_NO\_MEMORY**

  Insufficient memory was available.

- **GFARM\_ERR\_AUTHENTICATION**

  User authentication failed when connecting to [gfmd(8)](/gfmd/8.md).

- **GFARM\_ERR\_PERMISSION\_DENIED**

  *gfarm\_url* points outside your accessible address space.

- **GFARM\_ERR\_NO\_SUCH\_OBJECT**

  *section* of *gfarm\_url* does not exist.

- **GFARM\_ERR\_NOT\_A\_DIRECTORY**

  A component of the path prefix is not a directory.

- **Others**

  An error except the above occurred.  The reason is shown by its pointed strings.