---
name: "dwarf_line_srcfileno"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/dwarf_line_srcfileno"
---

# dwarf\_line\_srcfileno(3)

retrieve information associated with a DWARF line descriptor

## NAME

**dwarf\_lineaddr**, **dwarf\_linebeginstatement**, **dwarf\_lineblock**, **dwarf\_lineendsequence**, **dwarf\_lineno**, **dwarf\_lineoff**, **dwarf\_linesrc**, **dwarf\_line\_srcfileno** – retrieve information associated with a DWARF line descriptor

## LIBRARY

library “libdwarf”

## SYNOPSIS

**#include \<libdwarf.h\>**

*int*\

**dwarf\_lineaddr**(*Dwarf\_Line ln*, *Dwarf\_Addr \*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_linebeginstatement**(*Dwarf\_Line ln*, *Dwarf\_Bool \*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_lineblock**(*Dwarf\_Line ln*, *Dwarf\_Bool \*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_lineendsequence**(*Dwarf\_Line ln*, *Dwarf\_Bool \*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_lineno**(*Dwarf\_Line ln*, *Dwarf\_Unsigned \*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_lineoff**(*Dwarf\_Line ln*, *Dwarf\_Signed \*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_linesrc**(*Dwarf\_Line ln*, *char \*\*ret*, *Dwarf\_Error \*err*);

*int*\

**dwarf\_line\_srcfileno**(*Dwarf\_Line ln*, *Dwarf\_Unsigned \*ret*, *Dwarf\_Error \*err*);

## DESCRIPTION

These functions retrieve specific line information associated with the line descriptor specified by argument *ln*, and stores it in the location pointed to by argument *ret*. If argument *err* is not NULL, it will be used to store error information in case of an error.

Function **dwarf\_lineaddr**() stores the program address corresponding to the source line specified in argument *ln* into the location pointed to by argument *ret*.

Function **dwarf\_linebeginstatement**() sets the location pointed to by argument *ret* to 1 if the source line specified by the line descriptor *ln* is the beginning of a statement, or to 0 otherwise.

Function **dwarf\_lineblock**() sets the location pointed to by argument *ret* to 1 if the source line specified by the line descriptor *ln* is the beginning of a basic block, or to 0 otherwise.

Function **dwarf\_lineendsequence**() sets the location pointed to by argument *ret* to 1 if the program address associated with the line descriptor *ln* is the address immediately following the end of a sequence of target machine instructions, or to 0 otherwise.

Function **dwarf\_lineno**() stores the line number of the source line associated with the line descriptor *ln* into the location pointed to by argument *ret*.

Function **dwarf\_lineoff**() stores the column number within a line associated with descriptor *ln* into the location pointed to by argument *ret*. The retrieved column numbers are 1-based, with the value -1 indicating that column number information was not available.

Function **dwarf\_linesrc**() stores a pointer to a NUL-terminated string containing the source file name associated with line descriptor *ln* into the location pointed to by argument *ret*. The full path of the source file is returned if possible. The memory used for the source file name string is managed by the DWARF(3) library and should not be directly freed by application code. Instead, portable code should use [dwarf\_dealloc(3)](/dwarf_dealloc/3.md) to indicate that the string should be freed.

Function **dwarf\_line\_srcfileno**() stores the index of the source file associated with the line descriptor *ln* in the location pointed to by argument *ret*. The returned value is 1-based index into the array of source file names returned by [dwarf\_srcfiles(3)](/dwarf_srcfiles/3.md).

## RETURN VALUES

On success, these functions returns DW\_DLV\_OK. In case of an error, they return DW\_DLV\_ERROR and set the argument *err*.

## ERRORS

These functions may fail with the following errors:

- \[DW\_DLE\_ARGUMENT\]

  Either of the arguments *ln* or *ret* was NULL.

- \[DW\_DLE\_LINE\_FILE\_NUM\_BAD\]

  The source file name associated with the line descriptor *ln* could not be retrieved by function **dwarf\_linesrc**().

## SEE ALSO

[dwarf(3)](/dwarf/3.md), [dwarf\_dealloc(3)](/dwarf_dealloc/3.md), [dwarf\_srcfiles(3)](/dwarf_srcfiles/3.md), [dwarf\_srclines(3)](/dwarf_srclines/3.md)