---
name: "gnutls_random_art"
section: "3"
platform: "linux"
package: "gnutls"
version: "3.8.13-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_random_art"
---

# gnutls\_random\_art(3)

API function

## NAME

gnutls\_random\_art - API function

## SYNOPSIS

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

**int gnutls\_random\_art(gnutls\_random\_art\_t** *type***, const char \*** *key\_type***, unsigned int** *key\_size***, void \*** *fpr***, size\_t** *fpr\_size***, gnutls\_datum\_t \*** *art***);**

## ARGUMENTS

- gnutls\_random\_art\_t type

  The type of the random art (for now only **GNUTLS\_RANDOM\_ART\_OPENSSH** is supported)

- const char \* key\_type

  The type of the key (RSA, DSA etc.)

- unsigned int key\_size

  The size of the key in bits

- void \* fpr

  The fingerprint of the key

- size\_t fpr\_size

  The size of the fingerprint

- gnutls\_datum\_t \* art

  The returned random art

## DESCRIPTION

This function will convert a given fingerprint to an "artistic" image. The returned image is allocated using **gnutls\_malloc()**, is null-terminated but art-\>size will not account the terminating null.

## RETURNS

On success, **GNUTLS\_E\_SUCCESS** (0) is returned, otherwise an error code is returned.

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: https://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2023 Free Software Foundation, Inc., and others.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

- https://www.gnutls.org/manual/