---
name: "gnutls_crypto_single_mac_register2"
section: "3"
platform: "linux"
package: "gnutls-doc"
version: "2.8.6-1+squeeze3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_crypto_single_mac_register2"
---

# gnutls\_crypto\_single\_mac\_register2(3)

register a MAC algorithm

## NAME

gnutls\_crypto\_single\_mac\_register2 - register a MAC algorithm

## SYNOPSIS

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

**int gnutls\_crypto\_single\_mac\_register2(gnutls\_mac\_algorithm\_t** *algorithm***, int** *priority***, int** *version***, gnutls\_crypto\_single\_mac\_st \*** *s***);**

## ARGUMENTS

- gnutls\_mac\_algorithm\_t algorithm

  is the gnutls algorithm identifier

- int priority

  is the priority of the algorithm

- int version

  should be set to **GNUTLS\_CRYPTO\_API\_VERSION**

- gnutls\_crypto\_single\_mac\_st \* s

  is a structure holding new algorithms's data

## DESCRIPTION

This function will register a MAC algorithm to be used by gnutls. Any algorithm registered will override the included algorithms and by convention kernel implemented algorithms have priority of 90. The algorithm with the lowest priority will be used by gnutls.

This function should be called before **gnutls\_global\_init()**.

For simplicity you can use the convenience **gnutls\_crypto\_single\_mac\_register()** macro.

## RETURNS

**GNUTLS\_E\_SUCCESS** on success, otherwise an error.

## SINCE

2\.6.0

## REPORTING BUGS

Report bugs to \<bug-gnutls@gnu.org\>. GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/

## COPYRIGHT

Copyright © 2008 Free Software Foundation.\
 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 **info** and **gnutls** programs are properly installed at your site, the command

-

  **info gnutls**

should give you access to the complete manual.